Claude Bridge MCP

克劳德桥mcp

随时随地使用您的Claude Code MAX/PRO订阅。

一个MCP服务器，通过HTTP+SSE公开您的本地Claude Code CLI，因此任何兼容MCP的客户端-- 开爪Claude Desktop或您自己的代理可以远程使用您的Claude Code订阅。

Your PC (Claude MAX/PRO)              Remote Machine
┌──────────────────────┐              ┌──────────────────┐
│  claude-bridge-mcp   │◄────────────►│  OpenClaw Agent  │
│  :3100/sse           │   HTTP+SSE   │  Claude Desktop  │
│                      │   (Tailscale │  Custom MCP app  │
│  Spawns Claude CLI ──┤    or VPN)   └──────────────────┘
│  Uses YOUR sub  ─────┤
└──────────────────────┘

Your $100/mo MAX or $200/mo PRO → accessible from any machine

需求

• Node.js 18+
• 克劳德代码CLI 已安装并验证(claude PATH中的命令）-- 安装指南
• 活跃 克劳德代码MAX （100美元/月）或 专业版 （200美元/月）订阅

快速开始

# Run directly (no install needed)
npx claude-bridge-mcp

# Or install globally
npm install -g claude-bridge-mcp
claude-bridge-mcp

服务器启动于 http://0.0.0.0:3100.验证：

curl http://localhost:3100/health

从OpenClaw连接

将网桥添加为MCP服务器 ~/.openclaw/openclaw.json:

{
  "mcpServers": {
    "claude-bridge": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://:3100/sse"]
    }
  }
}

替换 ` 使用您电脑的IP地址。如果使用 [尾标](https://tailscale.com)，使用您的Tailscale IP(tailscale ip -4`).

现在，您的OpenClaw代理可以使用 claude_execute, claude_query, claude_read_file，以及 claude_git_status --所有这些都由您的Claude Code订阅提供支持。

从克劳德桌面连接

添加到您的Claude Desktop MCP配置(claude_desktop_config.json):

{
  "mcpServers": {
    "claude-bridge": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://:3100/sse"]
    }
  }
}

可用工具

配置

所有配置都是通过环境变量进行的。复制 .env.example 到 .env:

cp .env.example .env

安全

该网桥包括多个安全层：

• IP允许列表 --限制对特定IP的访问（例如，您的Tailscale网络）。本地主机始终允许。
• 承载令牌认证 --设置 BRIDGE_API_TOKEN 用于基于令牌的身份验证。
• 目录允许列表 --Claude CLI只能访问您明确允许的目录。
• Symlink保护 --路径通过以下方式解决 realpath() 在检查allolist之前，防止符号链接遍历。
• 执行队列 --FIFO队列具有可配置的并发限制和超时，以防止资源耗尽。

远程访问的推荐设置：

# Use Tailscale for encrypted networking
BRIDGE_ALLOWED_IPS=100.x.y.z    # Your remote machine's Tailscale IP
BRIDGE_API_TOKEN=your-secret     # Additional auth layer
BRIDGE_ALLOWED_DIRS=/path/to/project1,/path/to/project2

端点

运作原理

1. 远程MCP客户端连接到 /sse （服务器发送的事件）
2. 客户端通过以下方式发送工具调用 /messages （基于HTTP的JSON-RPC）
3. 桥梁产卵 claude CLI在本地与经过身份验证的会话一起使用
4. 结果通过SSE传回

这座桥使用 模型上下文协议 --AI工具通信的开放标准。

支持的平台

可在任何有Claude Code CLI和Node.js的地方运行：

相同机器使用： 该桥也可以在本地工作——对于只说MCP但需要Claude Code功能的应用程序很有用。只需连接到 http://localhost:3100/sse.

发展

git clone https://github.com/0motionguy/claude-bridge-mcp.git
cd claude-bridge-mcp
npm install
npm run dev    # Hot-reload development server
npm run build  # Production build

许可证

麻省理工学院-见 许可证

______________________________________________________________________

由...建造 ICM运动 为了 开爪 社区。