Claude Mcp Bridge

io.github.hampsterx/claude-mcp-bridge · v0.7.2

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

Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add claude-mcp-bridge -e CLAUDE_CLI_PATH=<CLAUDE_CLI_PATH> -e CLAUDE_DEFAULT_MODEL=<CLAUDE_DEFAULT_MODEL> -e CLAUDE_QUERY_MODEL=<CLAUDE_QUERY_MODEL> -e CLAUDE_STRUCTURED_MODEL=<CLAUDE_STRUCTURED_MODEL> -e CLAUDE_SEARCH_MODEL=<CLAUDE_SEARCH_MODEL> -e CLAUDE_FALLBACK_MODEL=<CLAUDE_FALLBACK_MODEL> -e CLAUDE_MAX_CONCURRENT=<CLAUDE_MAX_CONCURRENT> -e CLAUDE_BRIDGE_USE_API_KEY=<CLAUDE_BRIDGE_USE_API_KEY> -e CLAUDE_MAX_BUDGET_USD=<CLAUDE_MAX_BUDGET_USD> -e CLAUDE_QUERY_TOOLS=<CLAUDE_QUERY_TOOLS> -e CLAUDE_STRUCTURED_TOOLS=<CLAUDE_STRUCTURED_TOOLS> -e CLAUDE_SEARCH_TOOLS=<CLAUDE_SEARCH_TOOLS> -e CLAUDE_QUERY_EFFORT=<CLAUDE_QUERY_EFFORT> -e CLAUDE_SEARCH_EFFORT=<CLAUDE_SEARCH_EFFORT> -- npx -y [email protected]

claude_desktop_config.json

{
  "mcpServers": {
    "claude-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "CLAUDE_CLI_PATH": "<CLAUDE_CLI_PATH>",
        "CLAUDE_DEFAULT_MODEL": "<CLAUDE_DEFAULT_MODEL>",
        "CLAUDE_QUERY_MODEL": "<CLAUDE_QUERY_MODEL>",
        "CLAUDE_STRUCTURED_MODEL": "<CLAUDE_STRUCTURED_MODEL>",
        "CLAUDE_SEARCH_MODEL": "<CLAUDE_SEARCH_MODEL>",
        "CLAUDE_FALLBACK_MODEL": "<CLAUDE_FALLBACK_MODEL>",
        "CLAUDE_MAX_CONCURRENT": "<CLAUDE_MAX_CONCURRENT>",
        "CLAUDE_BRIDGE_USE_API_KEY": "<CLAUDE_BRIDGE_USE_API_KEY>",
        "CLAUDE_MAX_BUDGET_USD": "<CLAUDE_MAX_BUDGET_USD>",
        "CLAUDE_QUERY_TOOLS": "<CLAUDE_QUERY_TOOLS>",
        "CLAUDE_STRUCTURED_TOOLS": "<CLAUDE_STRUCTURED_TOOLS>",
        "CLAUDE_SEARCH_TOOLS": "<CLAUDE_SEARCH_TOOLS>",
        "CLAUDE_QUERY_EFFORT": "<CLAUDE_QUERY_EFFORT>",
        "CLAUDE_SEARCH_EFFORT": "<CLAUDE_SEARCH_EFFORT>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "claude-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "CLAUDE_CLI_PATH": "<CLAUDE_CLI_PATH>",
        "CLAUDE_DEFAULT_MODEL": "<CLAUDE_DEFAULT_MODEL>",
        "CLAUDE_QUERY_MODEL": "<CLAUDE_QUERY_MODEL>",
        "CLAUDE_STRUCTURED_MODEL": "<CLAUDE_STRUCTURED_MODEL>",
        "CLAUDE_SEARCH_MODEL": "<CLAUDE_SEARCH_MODEL>",
        "CLAUDE_FALLBACK_MODEL": "<CLAUDE_FALLBACK_MODEL>",
        "CLAUDE_MAX_CONCURRENT": "<CLAUDE_MAX_CONCURRENT>",
        "CLAUDE_BRIDGE_USE_API_KEY": "<CLAUDE_BRIDGE_USE_API_KEY>",
        "CLAUDE_MAX_BUDGET_USD": "<CLAUDE_MAX_BUDGET_USD>",
        "CLAUDE_QUERY_TOOLS": "<CLAUDE_QUERY_TOOLS>",
        "CLAUDE_STRUCTURED_TOOLS": "<CLAUDE_STRUCTURED_TOOLS>",
        "CLAUDE_SEARCH_TOOLS": "<CLAUDE_SEARCH_TOOLS>",
        "CLAUDE_QUERY_EFFORT": "<CLAUDE_QUERY_EFFORT>",
        "CLAUDE_SEARCH_EFFORT": "<CLAUDE_SEARCH_EFFORT>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "claude-mcp-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "CLAUDE_CLI_PATH": "<CLAUDE_CLI_PATH>",
        "CLAUDE_DEFAULT_MODEL": "<CLAUDE_DEFAULT_MODEL>",
        "CLAUDE_QUERY_MODEL": "<CLAUDE_QUERY_MODEL>",
        "CLAUDE_STRUCTURED_MODEL": "<CLAUDE_STRUCTURED_MODEL>",
        "CLAUDE_SEARCH_MODEL": "<CLAUDE_SEARCH_MODEL>",
        "CLAUDE_FALLBACK_MODEL": "<CLAUDE_FALLBACK_MODEL>",
        "CLAUDE_MAX_CONCURRENT": "<CLAUDE_MAX_CONCURRENT>",
        "CLAUDE_BRIDGE_USE_API_KEY": "<CLAUDE_BRIDGE_USE_API_KEY>",
        "CLAUDE_MAX_BUDGET_USD": "<CLAUDE_MAX_BUDGET_USD>",
        "CLAUDE_QUERY_TOOLS": "<CLAUDE_QUERY_TOOLS>",
        "CLAUDE_STRUCTURED_TOOLS": "<CLAUDE_STRUCTURED_TOOLS>",
        "CLAUDE_SEARCH_TOOLS": "<CLAUDE_SEARCH_TOOLS>",
        "CLAUDE_QUERY_EFFORT": "<CLAUDE_QUERY_EFFORT>",
        "CLAUDE_SEARCH_EFFORT": "<CLAUDE_SEARCH_EFFORT>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`CLAUDE_CLI_PATH` Optional	Path to the claude CLI binary. Defaults to 'claude' on PATH.
`CLAUDE_DEFAULT_MODEL` Optional	Shared default model for all tools. Overridden by per-tool CLAUDE_<TOOL>_MODEL vars (QUERY, SEARCH, STRUCTURED).
`CLAUDE_QUERY_MODEL` Optional	Override model for the query tool.
`CLAUDE_STRUCTURED_MODEL` Optional	Override model for the structured tool.
`CLAUDE_SEARCH_MODEL` Optional	Override model for the search tool.
`CLAUDE_FALLBACK_MODEL` Optional	Model to use when the primary model hits a quota error. Set to 'none' to disable fallback.
`CLAUDE_MAX_CONCURRENT` Optional	Maximum concurrent Claude CLI subprocesses (default 3).
`CLAUDE_BRIDGE_USE_API_KEY` Optional	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` Optional	Maximum USD spend per call (pass-through to --max-budget-usd). Only applies when using API key auth.
`CLAUDE_QUERY_TOOLS` Optional	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` Optional	Built-in tools the structured subprocess may use. Same format and caveats as CLAUDE_QUERY_TOOLS.
`CLAUDE_SEARCH_TOOLS` Optional	Built-in tools the search subprocess may use. Same format and caveats as CLAUDE_QUERY_TOOLS.
`CLAUDE_QUERY_EFFORT` Optional	Reasoning effort for the query tool (low\|medium\|high\|max).
`CLAUDE_SEARCH_EFFORT` Optional	Reasoning effort for the search tool (low\|medium\|high\|max).

Details

Package	`[email protected]` (NPM, stdio)
First published	18 Oct 2026
Last updated	18 Oct 2026
Registry name	`io.github.hampsterx/claude-mcp-bridge`

More search and web servers See all

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Claude Mcp Bridge often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-hampsterx-claude-mcp-bridge/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-hampsterx-claude-mcp-bridge)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.