Home › Development › claude-mcp-bridge

claude-mcp-bridge

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

TypeScript Local macOSWindowsLinux
★ 7 stars Last pushed 2026-10-18 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.2)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "claude-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ]
    }
  }
}
  • 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_TOOLS — Built-in tools the query subprocess may use. Comma or space separated list, 'default' for the CLI's full built-in set, or empty for no tools. The default withholds Bash, Write and Edit; widening it grants real capability in the caller-supplied working directory.
  • CLAUDE_STRUCTURED_TOOLS — Built-in tools the structured subprocess may use. Same format and caveats as CLAUDE_QUERY_TOOLS.
  • CLAUDE_SEARCH_TOOLS — Built-in tools the search subprocess may use. Same format and caveats as CLAUDE_QUERY_TOOLS.
  • 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