Claude MCP Bridge MCP Server

by hampsterxio.github.hampsterx/claude-mcp-bridgev0.7.1

Wraps the Claude Code CLI as MCP tools for queries, search, structured output and sessions, with budget caps and granular tool sandboxing.

7Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Claude MCP Bridge MCP server

claude mcp add claude-mcp-bridge -- npx -y claude-mcp-bridge

{
  "mcpServers": {
    "claude-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "claude-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "claude-mcp-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "claude-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
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).