Claude MCP Bridge

Wraps Claude Code CLI as MCP tools: query, search, structured, ping, listSessions. Its 5 documented tools cluster into read & search, structured, ping. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-03 · ★ 6 · #248 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Claude MCP Bridge

before you install - you'll need

ANTHROPIC_API_KEY, CLAUDE_BRIDGE_USE_API_KEY are optional or environment-specific per the README.

Claude Code

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

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package claude-mcp-bridge - unscoped; check the name against the project README before installing

registry namespace io.github.hampsterx is GitHub-verified and matches the repo owner

03 · What Claude MCP Bridge can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 5 documented tools across read & search, structured, ping, including query, search, structured, ping.

Capability map

Tools grouped from the project's README - what Claude MCP Bridge lets an agent do.

read & search

3 tools - e.g. Execute prompts with file context, session resume, effort control, and budget caps. Supports text and images. For code review, see Code review with this CLI.; Web search via Claude CLI's WebSearch and…

query · search · listSessions

Structured

1 tool - e.g. JSON Schema validated output via Claude CLI's native --json-schema.

structured

Ping

1 tool - e.g. Health check with CLI version, auth method, capabilities, and model config.

ping

Latest releases

v0.7.1 · 2026-08-03

No behaviour change. dist/ is byte-identical to 0.7.0, since src/ and prompts/ are untouched. This release exists to correct the package README. · What's new · Changed · Bridge family table no longer advertises a…

v0.7.0 · 2026-07-31

Upgrade recommended for all users. 0.6.1 and earlier let a crafted query prompt execute arbitrary commands. · What's new · Security · Caller-supplied values can no longer inject CLI flags - the prompt is passed after a…

v0.6.1 · 2026-05-04

What's new · Added · Docker image for container distribution (PR #22). Runs as non-root, suitable for the Glama MCP server listing. See Dockerfile for the canonical invocation. · Changed · ADR-001 reframed from "remove…

04 · Who maintains Claude MCP Bridge

claude-mcp-bridge is maintained by hampsterx. We track 3 MCP servers from hampsterx - 2 actively maintained, 15 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from hampsterx.

codex-mcp-bridge Wraps Codex CLI as MCP tools: codex, review, query, search, structured, ping, listSessions. ★ 3

05 · Facts

repository: github.com/hampsterx/claude-mcp-bridge
category: other - ranked #248 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-08-03)
registry: io.github.hampsterx/claude-mcp-bridge (active, first published 2026-04-20 · 5 versions)
packages: npm:claude-mcp-bridge

06 · Claude MCP Bridge FAQ

Is Claude MCP Bridge still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-03 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Claude MCP Bridge do?

An agent gets 5 documented tools across read & search, structured, ping, including query, search, structured, ping.

How do I install Claude MCP Bridge?

Run `npx -y claude-mcp-bridge`. The README documents 2 environment variables (ANTHROPIC_API_KEY, CLAUDE_BRIDGE_USE_API_KEY) to set first. ANTHROPIC_API_KEY, CLAUDE_BRIDGE_USE_API_KEY are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Claude MCP Bridge run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Claude MCP Bridge

Alternatives to Claude MCP Bridge

Maintained other servers if Claude MCP Bridge isn't the fit.

More MCP servers to compare · Codex MCP Bridge · ServiceNow Nodejs · Hashnet · Apple Notes · Eve Mentor MCP

More TypeScript MCP servers · Pexels MCP Server · Kanera · Apple Ads · Google Surf MCP · see all