HomeDevelopment › claude-mcp-bridge

claude-mcp-bridge

Wraps Claude Code CLI as MCP tools: query, search, structured, ping, listSessions.

TypeScript Local macOSWindowsLinux
★ 6 stars Last pushed 2026-08-03 License: MIT

Topics: Coding Agents

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 0.7.1)

npx -y claude-mcp-bridge@0.7.1

Or add to your MCP client config:

{
  "mcpServers": {
    "claude-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge@0.7.1"
      ],
      "env": {
        "CLAUDE_CLI_PATH": "<YOUR_VALUE>",
        "CLAUDE_DEFAULT_MODEL": "<YOUR_VALUE>",
        "CLAUDE_QUERY_MODEL": "<YOUR_VALUE>",
        "CLAUDE_STRUCTURED_MODEL": "<YOUR_VALUE>",
        "CLAUDE_SEARCH_MODEL": "<YOUR_VALUE>",
        "CLAUDE_FALLBACK_MODEL": "<YOUR_VALUE>",
        "CLAUDE_MAX_CONCURRENT": "<YOUR_VALUE>",
        "CLAUDE_BRIDGE_USE_API_KEY": "<YOUR_VALUE>",
        "CLAUDE_MAX_BUDGET_USD": "<YOUR_VALUE>",
        "CLAUDE_QUERY_EFFORT": "<YOUR_VALUE>",
        "CLAUDE_SEARCH_EFFORT": "<YOUR_VALUE>"
      }
    }
  }
}
  • CLAUDE_CLI_PATH — Path to the claude CLI binary. Defaults to 'claude' on PATH.
  • CLAUDE_DEFAULT_MODEL — Shared default model for all tools. Overridden by per-tool CLAUDE_<TOOL>_MODEL vars (QUERY, SEARCH, STRUCTURED).
  • CLAUDE_QUERY_MODEL — Override model for the query tool.
  • CLAUDE_STRUCTURED_MODEL — Override model for the structured tool.
  • CLAUDE_SEARCH_MODEL — Override model for the search tool.
  • CLAUDE_FALLBACK_MODEL — Model to use when the primary model hits a quota error. Set to 'none' to disable fallback.
  • CLAUDE_MAX_CONCURRENT — Maximum concurrent Claude CLI subprocesses (default 3).
  • CLAUDE_BRIDGE_USE_API_KEY — Set to '1' to forward ANTHROPIC_API_KEY to the CLI. Default is subscription-first: the CLI uses existing Max/Pro session and API key is NOT forwarded. Opt in only if you want API billing.
  • CLAUDE_MAX_BUDGET_USD — Maximum USD spend per call (pass-through to --max-budget-usd). Only applies when using API key auth.
  • CLAUDE_QUERY_EFFORT — Reasoning effort for the query tool (low|medium|high|max).
  • CLAUDE_SEARCH_EFFORT — Reasoning effort for the search tool (low|medium|high|max).

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry