mcpbeat Sign in

Claude MCP Bridge MCP Server

local only

Claude MCP Bridge runs on your own machine — the client starts it, so there is no endpoint to ping. 116 installs a week from npm. Last commit 3 Aug 2026.

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

Installs per day peak 166 · avg 19 · +150% w/w
a month agotoday
116
Installs / week
npm · claude-mcp-bridge
6
Stars
0 open issues
3 Aug 2026
Last commit
0 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 20 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

    version = execFileSync(binary, ["--version"], {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add claude-mcp-bridge -- npx -y claude-mcp-bridge
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "claude-mcp-bridge": {
      "args": [
        "-y",
        "claude-mcp-bridge"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.claude-mcp-bridge]
command = "npx"
args = ["-y", "claude-mcp-bridge"]
.cursor/mcp.json
{
  "mcpServers": {
    "claude-mcp-bridge": {
      "args": [
        "-y",
        "claude-mcp-bridge"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "claude-mcp-bridge": {
      "args": [
        "-y",
        "claude-mcp-bridge"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: 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).). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Claude MCP Bridge

same job, measured the same way
Codex MCP Bridge
by hampsterx

Wraps Codex CLI as MCP tools: codex, review, query, search, structured, ping, listSessions.

55 installs/wk local only
Claude Wrap MCP
by alex-kaff

MCP server that spawns and drives Claude Code sessions via claude-wrap.

72 installs/wk local only
Pare Search
by dave-london

Pare Search ג€” Structured code search operations (ripgrep + fd) as typed JSON.

local only
Actvt
by actvt

Query live Mac system metrics, listening ports, and Claude Code and Codex session history.

local only
Claude Code Explorer MCP
by nirholas

Explore the Claude Code CLI source — browse tools, commands, search code, and more.

35 installs/wk local only
Claude Code Explorer MCP
by divu2025

Explore the Claude Code CLI source — browse tools, commands, search code, and more.

28 installs/wk local only
showagent
by aytzey

Search, resume and convert AI coding sessions (Claude Code, Codex, Gemini, OpenCode, Pi) over MCP.

local only
Memex
by dioniipereyraa

One searchable memory of your Claude.ai chats and Claude Code sessions, served over MCP.

120 installs/wk local only

Claude MCP Bridge — questions

Answers built from our own checks of this server.

Why is there no uptime for Claude MCP Bridge?
Claude MCP Bridge runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package claude-mcp-bridge was installed 116 times last week.
How do I connect Claude MCP Bridge?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls claude-mcp-bridge straight from npm; nothing to host, nothing to sign up for.
How many people use Claude MCP Bridge?
The npm package claude-mcp-bridge was installed 116 times in the last week. Week over week that is +150%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Claude MCP Bridge open source?
Yes — it is published under the MIT licence, written in TypeScript and 6 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.