Phospho MCP Server

🚀 磷酸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请求。

📄 参考资料

• 模型上下文协议
• phosphobot