ROS2 MCP Server

MCPAI代理

提供方 kakimochi

AI代理 HTTP · 远程 无需鉴权 社区 / 第三方 Claude DesktopClaudeCline
查看接入方式

一个基于Python的服务器,集成模型上下文协议(MCP)与ROS 2,使AI助手能够通过ROS 2主题控制机器人。

一句话选型结论

按资料字段整理

ROS2 MCP Server 属于AI代理类 MCP 服务器,HTTP · 远程,无需鉴权,可直接接入 Claude Desktop、Claude、Cline,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式HTTP · 远程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 81 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

机器人控制Python本地部署ROS2集成AI助手MCP协议Python服务器

安装与配置

HTTP · 远程 无需鉴权
连远程 HTTPS 端点,通常为 Streamable HTTP
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cline,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
ROS2 MCP Server当前 未标注 HTTP · 远程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方kakimochi上游标注的维护方 kakimochi
分类AI代理本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.9 KB
来自项目仓库与上游目录的原文,未做删改

ros2-mcp服务器

ros2-mcp-server 是一个基于Python的服务器,它将模型上下文协议(MCP)与ROS 2集成在一起,使AI助手能够通过ROS 2主题控制机器人。它通过FastMCP处理命令,并作为ROS 2节点运行,发布 geometry_msgs/Twist 留言给 /cmd_vel 控制机器人运动的主题。

此实现支持“以0.2 m/s的速度前进5秒并停止”等命令 /cmd_vel 出版商名称 pub_cmd_vel.

特性

  • MCP集成:使用FastMCP处理来自MCP客户端(例如Claude)的命令。
  • ROS 2原生:作为ROS 2节点运行,直接发布到 /cmd_vel.
  • 基于时间的控制:支持基于持续时间的移动命令(例如,移动指定时间并停止)。
  • 异步处理:结合FastMCP asyncio ROS 2的事件循环可实现高效运行。

先决条件

  • ROS 2:安装和采购的分销渠道简陋。
  • python:版本3.10(与ROS 2 Humble兼容所需)。
  • 紫外线:用于依赖管理的Python包管理器。
  • 依赖项:
  • rclpy:ROS 2 Python客户端库(与ROS 2一起安装)。
  • fastmcp:用于MCP服务器实现的FastMCP框架。
  • numpy:ROS 2消息类型要求。

安装

  1. 克隆存储库:```bash
    git clone https://github.com/kakimochi/ros2-mcp-server.git
    cd ros2-mcp-server

1. **Python版本配置**:
本项目按照ROS 2 Humble的要求使用Python 3.10。这 `.python-version` 文件已配置:```bash
# .python-version content
3.10
  1. 项目依赖项:
    这 pyproject.toml 文件配置了必要的依赖关系:```toml

pyproject.toml content

[project]
name = "ros2-mcp-server"
version = "0.1.0"
description = "ROS 2 MCP Server"
readme = "README.md"
requires-python = ">=3.10"
dependencies = [
"fastmcp",
"numpy",
]


1. **创建紫外线环境**:```bash
uv venv --python /usr/bin/python3.10
  1. 激活虚拟环境:```bash
    source .venv/bin/activate

你会看到的 `(.venv)` 出现在命令提示符的开头,表示虚拟环境处于活动状态。

1. **再进行**:```bash
uv pip install -e .

MCP服务器配置

要将此服务器与Claude或其他MCP客户端一起使用,您需要将其配置为MCP服务器。以下是如何设置它:

适用于克劳德桌面

  1. 打开Claude Desktop设置并导航到MCP服务器部分。

  2. 添加具有以下配置的新MCP服务器:```json
    "ros2-mcp-server": {
    "autoApprove": [],
    "disabled": false,
    "timeout": 60,
    "command": "uv",
    "args": [
    "--directory",
    "/path/to/ros2-mcp-server",
    "run",
    "bash",
    "-c",
    "export ROS_LOG_DIR=/tmp && source /opt/ros/humble/setup.bash && python3 /path/to/ros2-mcp-server/ros2-mcp-server.py"
    ],
    "transportType": "stdio"
    }


**重要**:替换 `/path/to/ros2-mcp-server` 使用存储库的实际路径。例如,如果将存储库克隆到 `/home/user/projects/ros2-mcp-server`,你会选择那条路。

1. 保存配置并重新启动Claude。

### 对于Cline(VSCode扩展)

1. 在VSCode中,通过单击侧边栏中的Cline图标打开Cline扩展设置。

1. 导航到MCP服务器配置部分。

1. 添加具有以下配置的新MCP服务器:```json
"ros2-mcp-server": {
"autoApprove": [],
"disabled": false,
"timeout": 60,
"command": "uv",
"args": [
"--directory",
"/path/to/ros2-mcp-server",
"run",
"bash",
"-c",
"export ROS_LOG_DIR=/tmp && source /opt/ros/humble/setup.bash && python3 /path/to/ros2-mcp-server/ros2-mcp-server.py"
],
"transportType": "stdio"
}

重要:替换 /path/to/ros2-mcp-server 使用存储库的实际路径,如Claude Desktop示例中所示。

  1. 您可以立即打开/关闭服务器,并直接从Cline MCP设置界面验证连接,而无需重新启动VSCode或重新加载扩展。

用法

配置MCP服务器后,您可以使用Claude向机器人发送命令:

  1. 命令示例:
    让克劳德以0.2 m/s的速度向前移动机器人5秒:```
    Please make the robot move forward at 0.2 m/s for 5 seconds.

1. **直接工具使用**:
您还可以使用 `move_robot` 工具直接:```json
{
"linear": [0.2, 0.0, 0.0],
"angular": [0.0, 0.0, 0.0],
"duration": 5.0
}
  1. 监控ROS 2主题:
    验证 /cmd_vel 主题输出:```bash
    ros2 topic echo /cmd_vel

## 测试

1. **使用模拟器**:

- 启动与ROS 2兼容的模拟器(例如,带有TurtleBot3的Gazebo):```bash
export TURTLEBOT3_MODEL=burger
ros2 launch turtlebot3_gazebo turtlebot3_world.launch.py
  • 使用Claude发送移动命令。
  • 观察机器人在Gazebo中的移动。
  1. 与一个真正的机器人:
  • 确保您的机器人已正确设置以订阅 /cmd_vel 主题。
  • 使用Claude发送移动命令。
  • 机器人应该按照命令移动。
  1. 期望输出:
  • 服务器记录移动命令和停止命令。
  • Claude收到的回复如下: "Successfully moved for 5.0 seconds and stopped".

故障排除

  • ROS 2日志错误:如果遇到日志目录错误,请确保 ROS_LOG_DIR 环境变量被设置为可写目录(例如。, /tmp).
  • Python版本不匹配:确保您使用的是Python 3.10,因为ROS 2 Humble是为此版本构建的。
  • 连接错误:如果Claude报告“连接关闭”错误,请检查MCP服务器配置是否正确,以及是否安装了所有依赖项。

目录结构```

ros2-mcp-server/
├── ros2-mcp-server.py # Main server script integrating FastMCP and ROS 2
├── pyproject.toml # Project dependencies and metadata
├── .python-version # Python version specification
├── .gitignore # Git ignore file
└── README.md # This file


## 局限性

- **单一主题**:目前支持 `/cmd_vel` 随着 `Twist` 信息。扩展 `ros2-mcp-server.py` 其他主题或服务。
- **基本命令**:目前支持简单的移动命令。更复杂的行为需要额外的实现。

## 许可证```
MIT License

Copyright (c) 2025 kakimochi

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

请注意,此项目使用 FastMCP,根据Apache许可证2.0获得许可。该许可证的条款也适用于FastMCP组件的使用。

致谢

  • 内置于 FastMCP 和 ROS 2.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
ROS2 MCP Server 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

ROS2 MCP Server 怎么在 Claude Desktop、Claude、Cline 里配置?

它的传输方式是HTTP · 远程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

ROS2 MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

ROS2 MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

ROS2 MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cline;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

ROS2 MCP Server 能提供哪些能力?

资料显示能力标签包括 机器人控制、Python服务器、Python、Claude。具体工具清单以官方文档为准。

ROS2 MCP Server 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

ROS2 MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。