io.github.hampsterx/claude-mcp-bridge

io.github.hampsterx/claude-mcp-bridge·v0.5.1·Search

Quality Score

/100

MCP server wrapping Claude Code CLI for query, review, search, structured output, sessions.

Repository →

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "claude-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ],
      "env": {
        "CLAUDE_CLI_PATH": "claude",
        "CLAUDE_DEFAULT_MODEL": "<claude_default_model>",
        "CLAUDE_QUERY_MODEL": "sonnet",
        "CLAUDE_STRUCTURED_MODEL": "sonnet",
        "CLAUDE_SEARCH_MODEL": "sonnet",
        "CLAUDE_REVIEW_MODEL": "opus",
        "CLAUDE_FALLBACK_MODEL": "haiku",
        "CLAUDE_MAX_CONCURRENT": "3",
        "CLAUDE_BRIDGE_USE_API_KEY": "0",
        "CLAUDE_MAX_BUDGET_USD": "<claude_max_budget_usd>",
        "CLAUDE_QUERY_EFFORT": "<claude_query_effort>",
        "CLAUDE_REVIEW_EFFORT": "<claude_review_effort>",
        "CLAUDE_SEARCH_EFFORT": "<claude_search_effort>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "claude-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ],
      "env": {
        "CLAUDE_CLI_PATH": "claude",
        "CLAUDE_DEFAULT_MODEL": "<claude_default_model>",
        "CLAUDE_QUERY_MODEL": "sonnet",
        "CLAUDE_STRUCTURED_MODEL": "sonnet",
        "CLAUDE_SEARCH_MODEL": "sonnet",
        "CLAUDE_REVIEW_MODEL": "opus",
        "CLAUDE_FALLBACK_MODEL": "haiku",
        "CLAUDE_MAX_CONCURRENT": "3",
        "CLAUDE_BRIDGE_USE_API_KEY": "0",
        "CLAUDE_MAX_BUDGET_USD": "<claude_max_budget_usd>",
        "CLAUDE_QUERY_EFFORT": "<claude_query_effort>",
        "CLAUDE_REVIEW_EFFORT": "<claude_review_effort>",
        "CLAUDE_SEARCH_EFFORT": "<claude_search_effort>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y claude-mcp-bridge

§02 Environment variables

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, REVIEW, 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_REVIEW_MODEL

Override model for the review 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_REVIEW_EFFORT

Reasoning effort for the review tool (low|medium|high|max).

CLAUDE_SEARCH_EFFORT

Reasoning effort for the search tool (low|medium|high|max).

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in Search

Agentic News

ai.agentic-news/mcp

AI-powered news intelligence — 21 tools for personalized monitoring, briefings, and semantic search

BuyWhere MCP

ai.buywhere/buywhere-mcp

BuyWhere MCP server for product search, price comparison, and affiliate-ready shopping workflows.

Agent Skills Search Server

ai.com.mcp/skills-search

Search and discover Agent Skills from the skills.sh registry. Powered by HAPI MCP server.