openbot-mcp

openbot-mcp is the Model Context Protocol server for OpenBot.ai. It lets AI agents such as Claude Code, Cursor and Claude Desktop use OpenBot tools for physical AI data work.

Status: skeleton. PyPI has only the pre-release 0.1.0.dev0, published to reserve the name; pip install openbot-mcp does not select it. Only the server_status tool exists. Data audit, training readiness, Catalog and judgment tools are being designed.

Run from source

pip install -e ".[dev]"
OPENBOT_MCP_ROOTS=/path/to/data openbot-mcp

Claude Code:

claude mcp add openbot -e OPENBOT_MCP_ROOTS=/path/to/data -- openbot-mcp

Other MCP clients use the same command in their MCP configuration file:

{
  "mcpServers": {
    "openbot": {
      "command": "openbot-mcp",
      "env": { "OPENBOT_MCP_ROOTS": "/path/to/data" }
    }
  }
}

Configuration

Data boundary

Local tools only read the directories in OPENBOT_MCP_ROOTS and only write to the output directory. The server never modifies source data, never runs shell commands and collects no telemetry.

Development

pip install -e ".[dev]"
python scripts/check_version.py
pytest -v
ruff check src tests scripts
mypy src
python -m build

VERSION is the package version source of truth. To release, update VERSION and CHANGELOG.md, verify locally, then publish a GitHub Release whose tag is v<version>. The release workflow tests every supported Python, builds the distributions and publishes to PyPI through a trusted publisher.

Package boundaries

• openbot-mcp: MCP server for AI agents.
• openbot-data: local robot/ego data processing library.
• openbot-sdk: OpenBot platform API client.

License

MIT