Claude Local Bridge

克劳德当地大桥

通过手机从Claude访问您的本地存储库。不再被束缚在你的电脑上。

一个安全的网桥服务器，允许Claude（网络、移动、桌面）通过审批门控的MCP服务器在您的机器上读写文件。每次文件访问都需要您明确的OK——没有您的同意，任何东西都不会接触到磁盘。

┌──────────────────┐                          ┌────────────────────────┐
│  Claude Mobile   │    tunnel / LAN / VPN    │  Claude Local Bridge   │
│  Claude Web      │ ◄──────────────────────► │  (your PC)             │
│  Claude Desktop  │      MCP over SSE        │                        │
└──────────────────┘                          └──────────┬─────────────┘
                                                         │
                                               ┌─────────▼──────────┐
                                               │   Approval Gate    │
                                               │  (you approve each │
                                               │   file via dashboard│
                                               │   or phone)        │
                                               └─────────┬──────────┘
                                                         │
                                               ┌─────────▼──────────┐
                                               │   Local Files      │
                                               │  (sandboxed to     │
                                               │   workspace roots) │
                                               └────────────────────┘

特性

• MCP服务器 --Claude可以调用的7个工具：浏览、读取、写入、请求访问、列出/撤销批准、查看审计日志
• 审批门 --在您通过仪表板批准之前，每个文件的读/写都会被阻止
• 实时仪表盘 --用于管理审批、浏览文件、查看审计日志的工业主题web UI
• 沙盒化的 --只有您的白名单目录是可访问的
• 令牌认证 --启动时生成的用于配对的承载令牌
• 审计跟踪 --每次访问都记录了时间戳、操作、路径和结果
• 双向通信 --审批请求的实时推送通知
• 隧道准备就绪 --适用于Tailscale、Cloudflare Tunnel、NetBird或任何反向代理

快速开始

# Clone and install
git clone https://github.com/suhteevah/claude-local-bridge.git
cd claude-local-bridge
pip install -r requirements.txt

# Start the bridge (expose your project directories)
python -m app.main --roots ~/projects ~/code

服务器启动并打印：

🔗 Bridge Ready
  HTTP API:   http://127.0.0.1:9120
  MCP (SSE):  http://127.0.0.1:9120/mcp/sse
  Dashboard:  http://127.0.0.1:9120/
  Token:      a1b2c3d4e5f6...

连接克劳德

克劳德桌面/克劳德代码

添加到MCP设置(claude_desktop_config.json 或 .claude/settings.json):

{
  "mcpServers": {
    "local-bridge": {
      "url": "http://localhost:9120/mcp/sse"
    }
  }
}

克劳德·莫比尔（通过隧道）

设置隧道（参见 tunnel.md)因此，您的手机可以连接到服务器，然后使用隧道URL作为MCP端点。

最快选项 （无需帐户）：

# In a second terminal
cloudflared tunnel --url http://localhost:9120
# Gives you: https://random-words.trycloudflare.com
# Use: https://random-words.trycloudflare.com/mcp/sse

MCP工具

运作原理

1. 克劳德打电话来 browse_files 查看您的项目结构
2. 克劳德打电话来 request_file_access 有一个原因（“我需要阅读src/main.py来修复这个bug”）
3. 您的仪表板显示请求 --你赞成或否认
4. 如果获得批准，克劳德现在可以 read_file 或 write_file 在批准的范围内
5. 所有内容都记录在审计跟踪中

仪表盘

内置的web仪表板位于 http://localhost:9120/ 允许您：

• 批准/拒绝 实时访问请求（WebSocket供电）
• 浏览 工作区文件树
• 视图 带有过滤功能的完整审核日志
• 监视器 服务器状态和活动批准
• 撤销 随时批准

移动友好型设计——在克劳德工作时，通过手机管理审批。

HTTP API

完整的REST API也可用于自定义集成：

隧道选项

看 tunnel.md 获取详细的设置指南。摘要：

CLI选项

python -m app.main --roots DIR [DIR ...] [OPTIONS]

Options:
  --roots           Workspace directories to expose (required, multiple allowed)
  --host            Bind address (default: 127.0.0.1, use 0.0.0.0 for LAN/tunnel)
  --port            Port number (default: 9120)
  --max-file-size-mb  Max file size limit in MB (default: 10)

安全

• 沙箱根 --只有您明确传递的目录 --roots 可访问
• 扩展块列表 — .env, .pem, .key, .p12, .pfx, .secret 总是被封锁
• 路径遍历预防 — ../ 攻击被发现并被拒绝
• 承载令牌身份验证 -API终结点需要启动时生成的令牌
• 审批门控 --每个文件读/写都需要明确的人工批准
• 写时备份 --自动 .bak 在任何覆盖之前创建的文件
• 审核日志记录 --每次访问尝试的完整跟踪（成功与否）

项目结构

claude-local-bridge/
├── app/
│   ├── main.py              # Entry point, FastAPI + MCP setup
│   ├── mcp/
│   │   └── server.py        # MCP tools (browse, read, write, approve...)
│   ├── middleware/
│   │   └── auth.py          # Bearer token authentication
│   ├── models/
│   │   └── schemas.py       # Pydantic models and enums
│   ├── routers/
│   │   ├── approvals.py     # Approval CRUD endpoints
│   │   ├── audit.py         # Audit log endpoints
│   │   ├── files.py         # File read/write endpoints
│   │   └── ws.py            # WebSocket for real-time approvals
│   └── services/
│       ├── approval_service.py  # Approval state management
│       ├── audit_service.py     # In-memory audit log
│       └── file_service.py      # Sandboxed file operations
├── dashboard/
│   ├── index.html           # Dashboard shell
│   ├── style.css            # Industrial console theme
│   └── bridge.js            # API client + WebSocket
├── requirements.txt
├── tunnel.md                # Tunnel setup guide
└── README.md

许可证

麻省理工学院

______________________________________________________________________

______________________________________________________________________

______________________________________________________________________

支持这个项目

如果你觉得这个项目有用，可以考虑给我买杯咖啡！您的支持帮助我不断构建和共享开源工具。


每一笔捐款，无论多小，都受到极大的赞赏，并激励着持续的发展。非常感谢。