MCP Cobot Server

MCP Cobot 服务

此仓库包含 MCP Cobot 服务，这是一个面向 M5 MyCobot280 机器人的 FastMCP 服务实现。

基于 model context protocol python-sdk：https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#quickstart

功能

• 实现 MCP 标准，实现高效的上下文管理。
• 使用 FastMCP 构建，具备高性能和可扩展性。
• 专为集成协作机器人（myCobot）系统而设计。

要求

• Python 3.8+
• FastMCP 库

安装

1. 克隆仓库：

   git clone https://github.com/your-username/mcp-cobot-server.git
   cd mcp-cobot-server
   

2. 安装依赖：

   uv sync
   source .venv/bin/activate
   

注意：此项目使用 uv 安装和管理 Python 虚拟环境及依赖项。了解更多信息，请访问：https://docs.astral.sh/uv/guides/projects/

用法

启动服务：

# launch a standalone MCP server with:
uvx mcpo --port 8000 -- uv run --with mcp[cli] --with pymycobot mcp run ./server.py

# Install the mcp profile with claude
mcp install server.py

用于开发：

# debug the mcp interface
mcp dev server.py

可用函数

以下函数在 server.py 中通过 mcp.tool 对外提供：

1. get_angles：获取所有伺服电机的当前角度。
2. move_angle：以指定速度将特定关节（伺服电机）移动到目标角度。
3. move_angles：以指定速度将所有关节移动到指定角度。
4. go_home：将所有关节移动到预设的“初始”位置。
5. set_home：将当前关节角度设为新的“初始”位置。
6. change_color：更改机器人的 LED 矩阵颜色。
7. relax：释放所有伺服电机，使机械臂放松。
8. interpretive_dance_routine：根据描述执行创意舞蹈程序，包括关节运动和 LED 颜色变化。

MyCobot M5 280

我使用的 myCobot SDK 文档见：https://github.com/elephantrobotics/pymycobot/blob/main/docs/MyCobot_280_en.md 我使用的机器人见：Elephant Robotics myCobot 280 M5Stack 2023 - 6 DOF Collaborative Robot

关节范围

关节 ID	范围
1	-168 ~ 168
2	-135 ~ 135
3	-150 ~ 150
4	-145 ~ 145
5	-165 ~ 165
6	-180 ~ 180

贡献

欢迎贡献！请提交 issue 或拉取请求。

许可证

此项目采用 MIT 许可证。详情请参阅 LICENSE 文件。