Mcp4 Sdl

机器人控制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__)

Slide1.PNG 选项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__)

Slide2.PNG

备注\ 要查看上述界面，您需要使用应用程序链接创建一个帐户。 img.png 建议使用： ``text 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桌面（从任务栏退出的屏幕截图）

img.png

就是这样！你现在可以通过克劳德来控制你的机器人。

附加步骤

使用模拟设备/操作

如果您无法访问物理机器人，您可以通过创建来模拟设备操作 模拟函数或类.

提示示例

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.  

mock_sdl_prompt.png

开发者指南

开发者友好版本 服务器.py 对于贡献者。

uv add "mcp[cli]"
uv run mcp install server.py

使用示例

问克劳德：

• “告诉我更多关于平台的信息”
• “显示机器人状态”
• “执行校准工作流程”
• “将机器人移动到位置x=10，y=5”

故障排除

• 连接失败？ 检查IvoryOS是否在URL上运行
• 验证错误？ 在配置中验证用户名/密码，检查您是否可以使用该组合通过web应用程序登录。
• MCP未加载？ 配置更改后重新启动Claude Desktop

资源

• IvoryOS客户端: 仓库
• IvoryOS MCP: 仓库

贡献

欢迎黑客马拉松参赛者！ 任何贡献都有助于：

• 🤖 尝试使用您的平台 -使用您的机器人/硬件设置进行测试
• 📝 分享示例 -添加您的机器人控制脚本
• 🐛 报告问题 -什么坏了？缺少什么？
• 💡 建议功能 -什么会使它更有用？
• 📚 改进文档 -帮助他人更快地开始

任何贡献都不算太小——即使尝试一下并给出反馈也是有价值的！

______________________________________________________________________

🏆 黑客马拉松项目