ros mcp
 
将AI代理连接到ROS机器人。将主题、服务、节点、参数和操作作为MCP工具公开,可从Claude Desktop、Claude Code、Cursor或任何兼容MCP的客户端使用。
| 模式 | 最适合 |
|---|---|
| 浏览器仪表板 | 快速启动,无需安装 |
| Python服务器--stdio | 克劳德代码(本地) |
| Python服务器--HTTP | Claude桌面、光标、远程代理 |
| 远程CI服务器 | 共享/云托管设置 |
运作原理
浏览器仪表板完全跳过Python服务器——roslibjs通过嵌入式AI聊天面板从浏览器直接连接到rosbridge。
快速开始
git clone https://github.com/jonasneves/ros-mcp
cd ros-mcp浏览器仪表板 --打开 ,输入您的rosbridge WebSocket URL,然后连接。无需安装。
克劳德代码(stdio)
make configure克劳德桌面/光标(HTTP连接:9000)
ROSBRIDGE_IP= make server-http
make configure-desktop远程CI服务器
make configure-remoteDocker模拟器
3×Turtlesim --模拟器和罗斯布里奇自动启动,MCP服务器位于 http://localhost:9000/mcp:
make turtlesim艾萨克·辛 --需要安装了NVIDIA GPU、Isaac Sim并启用了ROS 2 Bridge扩展的Linux:
make isaac-sim # rosbridge (FastDDS, host network)
ROSBRIDGE_IP=127.0.0.1 make server-http # MCP server, separate terminal在macOS或远程机器上,直接指向已经与Isaac Sim一起运行的rosbridge: ROSBRIDGE_IP= make server-http.
工具
30多种工具,涵盖主题、服务、节点、动作、参数、机器人描述、关节状态、图像和运动控制。看 docs/tools.md 以获取完整参考。
配置
| 变量 | 默认值 | 描述 |
|---|---|---|
ROSBRIDGE_IP | 127.0.0.1 | 罗斯布里奇主机 |
ROSBRIDGE_PORT | 9090 | 罗斯布里奇港 |
ROS_DEFAULT_TIMEOUT | 5.0 | 超时时间(秒) |
许可证
Apache 2.0。看 许可证.
