Claude Bridge MCP server
io.github.constripacity/claude-code-bridge·v1.3.0·14 starsDurable local-first MCP relay for independent coding agents.
14 stars146 downloads/wk
Reviews
Write oneNobody has reviewed Claude Bridge yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Claude Bridge tools (3)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
bridge_channelsList all active channels and their message counts.
bridge_clearClear all messages from a specific channel. Useful for resetting state.
bridge_pingCheck if the bridge server is alive and get a status summary.
Public scan report
scanner v0.1.10 · 2026-11-01 · same rubric, same numbers if you re-run it
- Code scan28 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 71 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Claude Bridge compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,255 servers
- Tools
- 3
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 14
- more than 90% of 28,688 servers
- Downloads a week
- 146
- more than 70% of 12,191 servers with a package
What its tools let an agent do: 3 read
Install Claude Bridge in Claude Code, Cursor or VS Code
claude mcp add claude-code-bridge -- uvx claude-code-bridge
What the publisher says
From the Claude Bridge repository's README, as published. We do not edit it. Read it on GitHub
Claude Bridge
<!-- mcp-name: io.github.constripacity/claude-code-bridge -->
A local-first, cross-machine message bus for independent coding agents.
Claude Bridge lets coding-agent sessions on different machines exchange ordered messages through named channels. The relay is self-hosted, uses SQLite by default, and exposes MCP, a small JSON API, a dashboard, and a terminal UI.
It does not call a model API and does not require agents to share a filesystem or process. Claude Code motivated the project, but the core is MCP-based and is not coupled to Anthropic.
Forward-build notice: this source tree identifies as 1.2.0.dev1. It is
a development build beyond the latest stable PyPI release. Review the
changelog
and 0.9-to-1.2 migration guide
before replacing a stable deployment.
Why use it?
shell access.
- Keep agents on Windows, macOS, Linux, or a remote host in their own sessions.
- Send work, results, review requests, and artifact references without remote
- Use durable history and consumer cursors to recover after a client restart.
- Retry sends safely with an idempotency key.
- Observe the same relay through MCP, a browser dashboard, the TUI, or REST.
- Run locally or across a private LAN/tailnet with an explicit security policy.
Claude Bridge is a transport, not an autonomous orchestrator. Receiving a message never authorizes an agent to execute it.
Transports
The automated suite performs a real MCP SDK handshake against /mcp. Vendor clients are not launched in CI. See the evidence-based compatibility matrix.
Architecture
flowchart TB
A["Claude Code / Codex / MCP client"] -->|"Streamable HTTP /mcp"| B["Claude Bridge"]
C["Local MCP client"] -->|"stdio"| B
D["Dashboard / TUI / script"] -->|"REST + event SSE"| B
B --> E[("SQLite")]Messages and live-notification records are committed to SQLite in one transaction. HTTP processes poll that durable outbox (500 ms by default), so a write from a separate stdio process is propagated to connected dashboard/TUI event streams. Durable channel history remains authoritative across restarts.
Install
python -m pip install claude-code-bridgeInstall the terminal UI as well:
python -m pip install "claude-code-bridge[tui]"The PyPI distribution is named claude-code-bridge because claude-bridge was already assigned to an unrelated project. The command and Python package remain claude-bridge and claude_bridge.
From a source checkout:
git clone https://github.com/constripacity/Claude-Bridge.git
cd Claude-Bridge
python -m pip install -e ".[dev]"Start safely
Local-only HTTP mode is the default:
claude-bridgeThis listens on 127.0.0.1:8765. Open http://127.0.0.1:8765/ for the dashboard or connect an MCP client to http://127.0.0.1:8765/mcp.
Local stdio mode does not open a network listener:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Claude Bridge: common questions
- Is Claude Bridge MCP server safe?
- Mostly: it is graded B (78/100). Read the Claude Bridge safety report
- How do I install Claude Bridge?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Claude Bridge need an API key?
- Yes. The registry entry asks for
CLAUDE_BRIDGE_AUTH_TOKEN. - Is Claude Bridge maintained?
- The last commit was 73 days ago (2026-08-23). The latest release is v1.3.0.
- How does Claude Bridge compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,255 servers); tools 3 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.