@buildingopen/mcp-server

MCP server for RunIt. Lets AI agents (Claude, Cursor) deploy and run Python apps.

Setup

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "runit": {
      "command": "npx",
      "args": ["@buildingopen/mcp-server"],
      "env": {
        "RUNIT_URL": "http://localhost:3001",
        "RUNIT_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to MCP settings with the same command and environment variables.

Tools

The server exposes 18 tools for AI agents:

Deploy and Run

• deploy - Deploy Python code with optional config and requirements
• run - Execute an endpoint (auto-polls until result)
• list_projects - List all deployed apps
• get_project - Get app details and endpoint schemas

Version Management

• list_versions - Show dev/prod versions
• promote - Promote with health check and auto-rollback
• rollback - Rollback to a previous version

Secrets

• manage_secrets - List, set, or delete API keys (action param)

Storage

• storage_set / storage_get / storage_delete / storage_list - Persistent key-value store

Share Links

• create_share_link / list_share_links / disable_share_link - Public link management

Context

• fetch_context / list_contexts / delete_context - Attach external data sources

Logs

• get_logs - Recent run logs with error details and suggested fixes

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | RUNIT_URL | Yes | RunIt server URL | | RUNIT_API_KEY | No | API key (optional in OSS mode) |

License

MIT