pyBittle-mcp-服务器

一个 Python MCP（模型上下文协议）服务器，用于通过蓝牙控制 Bittle 机器人。该服务器使用 MCP 协议公开一组用于移动、摆姿势以及与 Bittle 交互的命令。

特征

• 通过蓝牙连接到 Bittle

• 显示运动和姿势命令（前进、后退、转身、坐下、休息等）

• 与 MCP 工具集成，实现远程和编程控制

• 将所有活动记录到bittle_mcp.log

Related MCP server: Bluetooth MCP Server

要求

• Python 3.10+

• uv用于包管理

• 具有蓝牙功能的 Bitle 机器人

• pyBittle库

• mcp-server库

安装和设置

1. 安装 uv（推荐用于快速、可靠的 Python 包管理）：

   curl -Ls https://astral.sh/uv/install.sh | sh

2. 安装依赖项：

   uv pip install -r requirements.txt # or, if using pyproject.toml: uv pip install -r pyproject.toml

用法

1. **配置蓝牙：**确保您的 Bittle 机器人已打开并处于蓝牙配对模式。

2. 运行 MCP 服务器：

   uv pip run python server.py

   服务器将尝试连接到 Bittle 并将状态记录到bittle_mcp.log 。

3. 与 MCP 工具集成：

   • 该服务器通过 MCP 协议公开命令，使任何与 MCP 兼容的客户端或工具都可以访问它们。

   • 您可以使用MCP CLI或其他 MCP 工具来发现和调用 Bittle 机器人上可用的命令。

   • 示例（使用 MCP CLI）：

     mcp call move_forward mcp call sit mcp call rest

   • 所有可用的命令都用server.py中的@mcp.tool()修饰，并自动在 MCP 服务器上注册。

发展

• 主要逻辑在server.py中。

• 日志配置为输出到控制台和bittle_mcp.log 。

• 命令用@mcp.tool()修饰，用于 MCP 曝光。

故障排除

• 如果服务器连接失败，请检查蓝牙配对并确保没有其他进程正在使用 Bittle 连接。

• 查看bittle_mcp.log以获取详细的错误消息。

执照

MIT 许可证