Phospho MCP Server

🚀 phospho-mcp-server

phospho 的官方 MCP 服務器。本項目實現了一個面向 phosphobot 的 模型上下文協議（Model Context Protocol，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 Desktop 中安裝 MCP 服務器

確保已安裝 Claude desktop。

使用 uv 按以下方式安裝 phospho-mcp-server：

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 上

# 克隆倉庫
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 desktop，你應該能在工具列表中看到 phospho 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