phospho

phospho-mcp-server exposes a lightweight MCP interface for controlling phosphobot-enabled robots from Claude. It provides two core tools: get_camera_frame, which streams a JPEG image from the local phosphobot camera, and pickup_object, which replays a pre-recorded action sequence to manipulate a specified object (e.g., banana, black circle, green cross). The server communicates with phosphobot via the local REST API (default http://localhost:80) and wraps calls through the phosphobot wrapper so Claude can invoke actions and retrieve camera imagery in real time. To use it, install phosphobot and run the MCP server within Claude Desktop, then select the phospho MCP server as a tool and issue natural language requests that map to these tools (for example, ask for the current view, or say "Pick up the banana").

Prerequisites:\n- Claude Desktop installed and accessible.\n- Python environment with uv (the Astral uv runtime) installed.\n- phosphobot installed and running locally (per phospho.ai docs).\n- Access to the phospho-mcp-server repository.\n\nStep-by-step installation:\n1) Install phosphobot (follow the phospho docs):\nbash\n# macOS\ncurl -fsSL https://raw.githubusercontent.com/phospho-app/phosphobot/main/install.sh | bash\n# Linux\ncurl -fsSL https://raw.githubusercontent.com/phospho-app/phosphobot/main/install.sh | sudo bash\n# Windows\npowershell -ExecutionPolicy ByPass -Command "irm https://raw.githubusercontent.com/phospho-app/phosphobot/main/install.ps1 | iex"\n``\n2) Install the MCP server (phospho-mcp-server) using uv:\nbash\ncurl -LsSf https://astral.sh/uv/install.sh | sh # install uv on macOS/Linux\npowershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" # Windows (if needed)\n# Clone the MCP server repo\ngit clone https://github.com/phospho-app/phospho-mcp-server.git\n\n# Install the MCP server (navigate into the project)\ncd phospho-mcp-server/phospho-mcp-server\nuv run mcp install server.py\n\n3) Run the MCP server (development mode):\nbash\nuv run mcp dev server.py\n```\n4) In Claude Desktop, ensure phospho MCP server appears under Tools and select it to begin issuing commands.

Tips and notes:\n- The MCP server communicates with local phosphobot via REST (default http://localhost:80). If phosphobot runs on a different port, update the base URL in the wrapper accordingly.\n- The tools exposed are get_camera_frame (returns a base64-encoded JPEG) and pickup_object (takes a name argument from a limited set).\n- When testing in Claude, you can try simple queries like asking for the current camera frame or instructing a replay based on a known object name.\n- If you see issues with tool registration, ensure phosphobot is running and that phospho-mcp-server’s wrapper (tools/phosphobot.py) can reach the local API.\n- For development, use uv run mcp dev server.py to enable live testing with the MCP inspector.