🚀 磷酸MCP服务器（phospho - mcp - server）
本项目是phospho的官方MCP服务器。它实现了一个针对phosphobot的模型上下文协议（MCP） 服务器，支持通过自然语言与实体机器人进行交互和控制。该服务器提供了执行动作（如拾取物体）和从摄像头获取图像流的工具。本项目基于mcp构建，并针对Claude进行了优化。
✨ 主要特性
- 摄像头图像流：获取当前网络摄像头的画面。
- 回放工具：从数据集中触发机器人动作（如拾取香蕉）。
- phosphobot包装器：管理本地API进程和通信。
🚀 快速开始
1. 安装并运行phosphobot
phosphobot是一款开源软件，可用于控制机器人、记录数据、训练和使用VLA（视觉语言动作模型）。
运行以下命令安装phosphobot：
# macOS
curl -fsSL https://raw.githubusercontent.com/phospho-app/phosphobot/main/install.sh | bash
# Linux
curl -fsSL https://raw.githubusercontent.com/phospho-app/phosphobot/main/install.sh | sudo bash
# Windows
powershell -ExecutionPolicy ByPass -Command "irm https://raw.githubusercontent.com/phospho-app/phosphobot/main/install.ps1 | iex"
运行phosphobot服务器：
phosphobot run
2. 在Claude桌面端安装MCP服务器
确保已安装Claude桌面端。
使用uv按以下方式安装磷酸MCP服务器：
curl -LsSf https://astral.sh/uv/install.sh | sh # 在MacOs或Linux上安装uv
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # 在Windows上安装uv
# 克隆仓库
git clone https://github.com/phospho-app/phospho-mcp-server.git
# 安装服务器
cd phospho-mcp-server/phospho-mcp-server
uv run mcp install server.py
这将：
- 以
phospho的名称启动MCP服务器。 - 注册所有工具。
现在，打开Claude桌面端，你应该能在工具列表中看到磷酸MCP服务器。
📚 详细文档
工作原理
该服务器通过REST API（默认http://localhost:80）与phosphobot的本地实例进行通信。
/frames→ 图像流/recording/play→ 从数据集中触发回放
所有调用都通过tools/phosphobot.py进行包装。如果你在不同的端口上运行phosphobot，则需要修改基础URL。
开发与测试
要使用MCP检查器测试你的服务器，请运行：
uv run mcp dev server.py
从Claude获取摄像头图像
提问：
“我的桌子上有什么？”
Claude将调用：
{
"tool": "get_camera_frame"
}
从Claude触发回放
提问：
“捡起香蕉”
Claude将调用：
{
"tool": "pickup_object",
"args": { "name": "banana" }
}
💻 使用示例
pickup_object
启动回放情节以模拟物体操作。
@mcp.tool()
def pickup_object(name: Literal["banana", "black circle", "green cross"]) -> str
- 根据物体名称启动预录制的情节。
get_camera_frame
从phosphobot的摄像头捕获JPEG图像。
@mcp.tool()
def get_camera_frame() -> Image
- 使用本地phosphobot API (
/frames)。 - 返回Base64编码的JPEG图像。
🔧 技术细节
项目架构
phospho-mcp-server/
│
├── server.py # 带有工具的MCP服务器（FastMCP）
├── tools/
│ ├── phosphobot.py # phosphobot进程和API的包装器
│ └── replay_api.py # 启动回放的工具
├── pyproject.toml # 项目配置
└── README.md # 本文件
PhosphoClient类用于管理phosphobot进程的生命周期，并向其本地API发送GET/POST请求。