使用说明
机器人控制MCP
通过Claude Desktop使用模型上下文协议（MCP）和 象牙.
快速开始
1.安装Ivory
在现有脚本环境中，安装ivoryos
pip install ivoryos
2.启动IvoryOS
选项A-功能块：
import ivoryos
@ivoryos.block
def move_robot(x: float, y: float, z: float):
"""Move robot to specified coordinates"""
# Your robot control logic here
return True
ivoryos.run(__name__)
选项B-类实例：
import ivoryos
class RobotController:
def move(self, x: float, y: float, z: float):
"""Move robot to specified coordinates"""
# Your robot control logic here
return True
robot = RobotController()
ivoryos.run(__name__)
备注
要查看上述界面，您需要使用应用程序链接创建一个帐户。建议使用：
username: admin password: admin为了便于访问。
如果您选择了其他用户名/密码，请记住在步骤5中更新配置文件。
3.安装uv和克劳德桌面
在Windows上安装uv：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
在Mac上安装uv：
curl -LsSf https://astral.sh/uv/install.sh | sh
4.配置克劳德桌面
添加到您的Claude Desktop配置文件中：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%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": "your_username",
"IVORYOS_PASSWORD": "your_password"
}
}
}
}
5.重新启动克劳德桌面
退出Windows上的Claude桌面（从任务栏退出的屏幕截图）
就是这样！你现在可以通过克劳德来控制你的机器人。
附加步骤
使用模拟设备/操作
如果您无法访问物理机器人，您可以通过创建来模拟设备操作 模拟函数或类.
提示示例
Can you provide a dummy self-driving lab script in Python, representing unit operations in chemistry?
I want one version using a class, and another example using simple functions.
Functions should be meaningful and can be scripted as a workflow/experiment.
Use primitive data inputs wherever possible.
Finally, provide a natural language summary of the experiment.
开发者指南
开发者友好版本 服务器.py 对于贡献者。
uv add "mcp[cli]"
uv run mcp install server.py
使用示例
问克劳德：
- “告诉我更多关于平台的信息”
- “显示机器人状态”
- “执行校准工作流程”
- “将机器人移动到位置x=10，y=5”
故障排除
- 连接失败？ 检查IvoryOS是否在URL上运行
- 验证错误？ 在配置中验证用户名/密码，检查您是否可以使用该组合通过web应用程序登录。
- MCP未加载？ 配置更改后重新启动Claude Desktop
资源
贡献
欢迎黑客马拉松参赛者！ 任何贡献都有助于：
- 🤖 尝试使用您的平台 -使用您的机器人/硬件设置进行测试
- 📝 分享示例 -添加您的机器人控制脚本
- 🐛 报告问题 -什么坏了？缺少什么？
- 💡 建议功能 -什么会使它更有用？
- 📚 改进文档 -帮助他人更快地开始
任何贡献都不算太小——即使尝试一下并给出反馈也是有价值的！
🏆 黑客马拉松项目
