AI导哈

Claude桥接服务

一个将本地Claude Code CLI通过HTTP+SSE暴露为MCP协议的服务，支持远程使用Claude Code订阅功能。

  • by 0motionguy
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 0motionguy/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://<your-pc-ip>:3100/sse"]
    }
  }
}

替换 <your-pc-ip> 使用您电脑的IP地址。如果使用 尾标，使用您的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://<your-pc-ip>:3100/sse"]
    }
  }
}

可用工具

工具 说明
claude_execute 使用Claude代码执行任务。完整的编码功能：读/写文件、运行命令、git操作。
claude_query 向Claude Code提问（只读，快速）。非常适合代码分析和解释。
claude_read_file 从PC文件系统读取文件。
claude_git_status 获取git状态：分支、更改和最近提交。

配置

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

cp .env.example .env
变量 默认值 描述
BRIDGE_HOST 0.0.0.0 绑定地址
BRIDGE_PORT 3100 服务器端口
BRIDGE_API_TOKEN （无） 用于身份验证的承载令牌。如果已设置，则所有请求（除 /health)要求 Authorization: Bearer <token>
BRIDGE_ALLOWED_IPS （空=全部） 逗号分隔的IP地址列表。空表示允许所有IP。始终允许本地主机。
BRIDGE_ALLOWED_DIRS （空=cwd） 逗号分隔的目录列表。当前工作目录默认为空。
BRIDGE_TIMEOUT 120000 执行超时（毫秒）
BRIDGE_MAX_CONCURRENT 2 最大并发Claude CLI执行数
BRIDGE_QUEUE_TIMEOUT 30000 队列等待超时（毫秒）

安全

该网桥包括多个安全层：

  • 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

端点

端点 方法 描述
/sse MCP客户端的GET SSE连接
/messages POST JSON-RPC消息端点
/health GET 健康检查（无需身份验证）
/metrics GET 服务器指标

运作原理

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

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

支持的平台

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

平台 备注
视窗 10/11 完全支持
macOS （英特尔和苹果硅） 全面支持
Linux （Ubuntu、Debian等） 完全支持
Linux虚拟专用服务器 （AWS、DigitalOcean等） 在任何云VM上运行网桥
码头工人 node:18-alpine 或类似
Mac Mini （无头服务器） 非常棒，就像一个永远在线的网桥
Termux （安卓） 设置 BRIDGE_ALLOWED_DIRS 明确
WSL2 全力支持

相同机器使用： 该桥也可以在本地工作——对于只说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运动 为了 开爪 社区。

相关 MCP