podflare-mcp

MCP server that exposes Podflare sandboxes to any MCP-capable client (Claude Desktop, Cursor, Cline, Zed, Windsurf).

Tools exposed:

• run_python(code) — execute Python and return {stdout, stderr, exit_code}
• run_bash(code) — execute a bash snippet

A single sandbox is shared across tool calls within an MCP session.

Claude Desktop config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "podflare": {
      "command": "node",
      "args": ["/absolute/path/to/podflare/mcp/dist/index.js"],
      "env": {
        "PODFLARE_HOST": "http://127.0.0.1:7070"
      }
    }
  }
}

Make sure podflare-hostd is running on PODFLARE_HOST before starting Claude.

Dev

npm install
npm run dev   # runs via tsx, no build step

Phase 1 note: REPL state does not persist across tool calls because the subprocess executor spawns a fresh Python process each time. Persistent REPL state arrives in Phase 2 when the Firecracker executor + in-guest REPL daemon land.