使用说明
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_USERNAME>",
"IVORYOS_PASSWORD": "<IVORYOS_PASSWORD>"
}
}
}
}
📦 安装
安装 紫外线.
1.克隆存储库
git clone https://gitlab.com/heingroup/ivoryos-mpc
cd ivoryos-mcp
2.安装依赖项
使用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/<deck_name> |
列出数据库中的所有工作流脚本 |
load-workflow-script |
GET /library/<workflow_name> |
从数据库加载工作流脚本 | |
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/<workflow_id> |
加载执行日志和数据文件 | |
| 🤖 直接控制 | execute-task |
POST /instruments/<component> |
直接调用平台功能 |
| 🤖 工作流运行 | 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示例。
