{"id":"87e3a9c4-6088-40a4-a88f-f69178c263c1","slug":"jaimejunr-claude-mcp-bridge","kind":"mcp","name":"claude-mcp-bridge","summary":"Let any AI agent (Cursor, Codex, Gemini/Antigravity) delegate to Claude Code via MCP: adversarial code review, validation & fully autonomous coding tasks — with model + effort control and session foll","owner":"JaimeJunr","repoUrl":"https://github.com/JaimeJunr/claude-mcp-bridge","license":"MIT","licenseTier":"permissive","trust":"community","stars":2,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-06-22T19:07:14.000Z","addedAt":"2026-10-21T06:16:58.655Z","logoUrl":"https://avatars.githubusercontent.com/u/138415231?u=67be574cb26bdef8ee8c6e4abcc4c8428c4e255d&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools","memory-knowledge"],"tags":["agent-delegation","ai-agents","ai-code-review","anthropic","claude","claude-code","code-review","developer-tools"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-26T21:47:46.903Z","sample":false,"url":"https://conduits.dev/tools/jaimejunr-claude-mcp-bridge","language":"TypeScript","transports":["stdio"],"install":{"npm":"claude-mcp-bridge"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# claude-mcp-bridge\n\nMCP server that lets **any** agent or MCP host (Cursor, Codex, Antigravity, another Claude Code,\nyour own app) escalate to **Opus** via **Claude Code** running headless (`claude -p` / `claude --bg`).\n\nOpus is **expensive but very capable** — this bridge is deliberately narrow: complex reasoning,\narchitecture questions, adversarial review, and autonomous work. Cheap mechanical work (mapping a\nrepo, scanning files) should stay on the host agent's lighter model.\n\nNested MCP delegation is **blocked**: Opus sessions spawned by this bridge cannot call\nclaude-mcp-bridge (or any MCP) again.\n\n## Tools\n\n| Tool | Purpose | Model |\n|------|---------|-------|\n| `ask` | Read-only Q&A — architecture, explanation, planning (`claudecode({ prompt: \"...\" })`) | **Opus** (forced) |\n| `delegate` | Full autonomous task — edit, shell, tests (max turns, synchronous) | **Opus** (forced) |\n| `fire` | Fire-and-forget background task — returns `session_id` immediately | **Opus** (forced) |\n| `check` | Compact progress report for a `fire` session | read-only (no model) |\n| `follow_up` | Continue a prior session by `session_id` | **Opus** (forced) |\n\n### Parallel background tasks\n\n```\nfire({ prompt: \"Refactor the auth module to use JWT\" })\n→ returns session_id immediately\n\ncheck({ session_id: \"...\" })\n→ check progress anytime\n```\n\n### Examples\n\n```json\n// Ask Opus to explain architecture (read-only)\n{ \"prompt\": \"Explain the architecture of this project\" }\n\n// Delegate autonomous work (waits for completion)\n{ \"prompt\": \"Refactor auth to JWT and fix all tests\" }\n\n// Background refactor — poll while you keep working\n{ \"prompt\": \"Refactor the auth module to use JWT\", \"name\": \"JWT refactor\" }\n// → session_id: ...\n{ \"session_id\": \"...\" }\n```\n\nEvery tool accepts: `cwd` (project root), `effort` (`low` \\| `medium` \\| `high`, default `high`).\n\n## Requirements\n\n- Node ≥ 18\n- [`claude`](https://claude.com/claude-code) CLI v2.1.139+ installed and authenticated (`claude` once to log in).\n  Background tasks (`fire` / `check`) require `claude --bg` and `claude agents --json`.\n\n## Install\n\n```bash\ngit clone https://github.com/JaimeJunr/claude-mcp-bridge.git\ncd claude-mcp-bridge\nnpm install\nnpm run build\n```\n\n## Register in an MCP host\n\n**Claude Code:**\n```bash\nclaude mcp add claude-bridge -s user -- node /abs/path/to/claude-mcp-bridge/dist/index.js\n```\n\n**Cursor / Codex / any host** — add to its `mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"claude-bridge\": {\n      \"command\": \"node\",\n      \"args\": [\"/abs/path/to/claude-mcp-bridge/dist/index.js\"]\n    }\n  }\n}\n```\n\n## Configuration (env)\n\n| Var | Default | Meaning |\n|-----|---------|---------|\n| `CLAUDE_BIN` | `claude` | Path to the `claude` binary. |\n| `CLAUDE_BRIDGE_MODEL` | `opus` | Model alias — always Opus in this bridge. |\n| `CLAUDE_BRIDGE_EFFORT` | `high` | Default reasoning effort. |\n| `CLAUDE_BRIDGE_MAX_TURNS` | `20` | Max agentic turns for `delegate` / `fire`. |\n| `CLAUDE_BRIDGE_PERMISSION` | `acceptEdits` | Permission mode for delegate/fire: `plan` \\| `default` \\| `acceptEdits` \\| `bypassPermissions`. |\n| `CLAUDE_BRIDGE_TIMEOUT_MS` | `600000` | Per-call timeout for sync tools (`ask`, `delegate`). |\n| `CLAUDE_BRIDGE_SHORT_TIMEOUT_MS` | `30000` | Timeout for `fire` / `check`. |\n\n> **Security:** `acceptEdits` lets delegated Opus edit files autonomously; `bypassPermissions`\n> additionally allows unrestricted shell. Only raise this for trusted workspaces. `ask` always\n> uses `plan` (read-only).\n\n## Develop\n\n```bash\nnpm test       # vitest — unit tests for arg building / json parsing\nnpm run dev    # run from source via tsx\n```\n\n## License\n\nMIT\n"}