IvoryOS MCP服务器
 
用作机器人控制界面，使用 象牙 以及模型上下文协议（MCP），用于设计、管理工作流并与当前的硬件/软件执行层交互。
🚀 快速入门 克劳德桌面
安装 紫外线. 打开配置文件，添加IvoryOS MCP配置。
- macOS：~/库/应用程序支持/Claude/Claude_desktop_config json
- Windows：%APPDATA%\\Claude\\Claude_desktop_config.json
{
"mcpServers": {
"IvoryOS MCP": {
"command": "uvx",
"args": [
"ivoryos-mcp"
],
"env": {
"IVORYOS_URL": "http://127.0.0.1:8000/ivoryos",
"IVORYOS_USERNAME": "",
"IVORYOS_PASSWORD": ""
}
}
}
}📦 安装
安装 紫外线.
1.克隆存储库
git clone https://gitlab.com/heingroup/ivoryos-mpc
cd ivoryos-mcp2.安装依赖项
使用IDE（例如PyCharm）时 uv 环境可能已配置，您可以跳过此部分。
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -r uv.lock⚙️ 配置
选项1：in .env，更改ivoryOS url和登录凭据。
IVORYOS_URL=http://127.0.0.1:8000/ivoryos
IVORYOS_USERNAME=admin
IVORYOS_PASSWORD=admin选项2：在 ivoryos_mcp/server.py，更改ivoryOS url和登录凭据。
url = "http://127.0.0.1:8000/ivoryos"
login_data = {
"username": "admin",
"password": "admin",
}🚀 安装服务器（在 克劳德桌面)
mcp install ivoryos_mcp/server.py✨ 特性
| 类别 | 特性 | 路线 | 描述 |
|---|---|---|---|
| ℹ️ 通用工具 | platform-info | GET /instruments | 获取ivoryOS信息和平台签名 |
execution-status | GET /executions/status | 检查系统是否繁忙以及当前/上次任务状态 | |
| ℹ️ 工作流程设计 | list-workflow-scripts | GET /library/ | 列出数据库中的所有工作流脚本 |
load-workflow-script | GET /library/ | 从数据库加载工作流脚本 | |
submit-workflow-script | POST /draft/submit_python | 将工作流Python脚本保存到数据库 | |
get-optmizer-schema | POST /executions/optimizer_schema | 获取所有优化器架构 | |
| ℹ️ 工作流数据 | list-workflow-data | GET /executions/records | 列出可用的工作流执行数据 |
load-workflow-data | GET /executions/records/ | 加载执行日志和数据文件 | |
| 🤖 直接控制 | execute-task | POST /instruments/ | 直接调用平台功能 |
| 🤖 工作流运行 | run-workflow-repeat | POST /executions/config | 使用静态参数反复运行工作流脚本 |
run-workflow-kwargs | POST /executions/config | 使用动态参数运行工作流脚本 | |
run-workflow-campaign | POST /executions/campaign | 使用优化器运行工作流活动 | |
| 🤖 流程控制 | pause-and-resume | GET /executions/pause-resume | 暂停或恢复工作流执行 |
abort-pending-workflow | GET /executions/abort/next-iteration | 完成当前迭代，中止未来执行 | |
stop-current-workflow | GET /executions/abort/next-task | 安全停止当前工作流程 |
⚠️ ℹ️ 是资源，但由于MCP Python SDK和Claude Desktop集成的当前问题，被装饰为工具。\ 建议仅使用allow always为了ℹ️ 任务\ 和使用allow once为了🤖 任务。 这些任务将触发对托管Python代码的实际操作。
🧪 例子
示例提示使用抽象SDL示例。