Skip to main content
Glama
pi-bridge

pi-bridge

by cr-zhichen

pi-bridge

pi-bridge 让 Claude 和 ChatGPT 网页版调用你电脑上的 Pi:运行命令、读写文件,以及使用 Pi 已安装的 Skills、扩展和 MCP 服务器。模型仍是网页版里的那个,本机不额外调用模型。

它由两部分组成:部署在 Cloudflare Workers 上的服务端,提供网页版接入用的 MCP 地址;运行在电脑上的 pi-bridge 命令行,负责连接服务端并在本机执行。一个服务端可以供多人使用,每人可以连接多台电脑。

部署服务端

需要一个 Cloudflare 账号并启用 R2,免费套餐即可。两种方式任选其一。

一键部署

Deploy to Cloudflare

按页面提示连接 GitHub 并填写 ADMIN_KEY(登录管理页的密钥,请设置一串足够长的随机字符)。Cloudflare 会在你的 GitHub 账号下创建一个新仓库并完成部署。这个仓库不会随本项目自动更新,升级时需要手动合并改动;想方便升级,请使用下面的方式。

Fork 后部署

  1. Fork 本仓库。

  2. 在 Cloudflare 控制台打开 Workers & Pages → Create → Import a repository,选择你的 Fork。

  3. 在构建设置中把 Root directory 设为 packages/server,其余保持默认,部署。

  4. 打开这个 Worker 的 Settings → Variables and Secrets,添加类型为 Secret 的 ADMIN_KEY。

升级时在 Fork 页面点击 Sync fork → Update branch,Cloudflare 会自动重新部署,用户和设备数据都会保留。

服务端用一个名为 OAUTH_KV 的 KV 命名空间保存网页版连接器的授权,部署时自动创建,不需要手动配置。

临时文件

部署后,在 Worker 的 Bindings 找到 TRANSFER_FILES 对应的存储桶,保持存储桶私有,并设置对象生命周期规则,将 transfers/ 下的文件设为 1 天后删除。

创建用户

部署完成后,在浏览器打开 https://<服务地址>/admin,用 ADMIN_KEY 登录,为每位使用者创建用户。创建后页面会显示这位用户的用户名和初始密码,只显示一次。用户忘记密码时,在管理页重置密码。

用户用用户名和密码登录 https://<服务地址>/account,第一次登录需要修改密码,之后在账号页自己添加电脑、连接网页版 AI。管理员看不到用户的密钥。

从旧版本升级时,每位老用户原来的密钥会变成一个「迁移的旧密钥」,已登录的电脑和已配置的连接器继续可用。老用户还没有登录账号,管理页会标出「未设置登录账号」,点「设置登录账号」生成用户名和初始密码。登录后账号页会提示更换旧密钥。

配置项

作用

默认值

ADMIN_KEY

登录管理页的密钥

无,必须设置

Related MCP server: LocalPilot

连接电脑

电脑需要先安装 Pi 0.99 或更高版本,以及 Node.js 22.19 或更高版本。pi-bridge 使用电脑上安装的 Pi,网页版能用的扩展、Skills 和 MCP 与终端里的 pi 相同。安装命令行:

npm install -g @zgccrui/pi-bridge

在账号页点「添加电脑」,填写电脑名称后会生成这台电脑专用的登录命令。在电脑上运行它,然后启动 pi-bridge:

pi-bridge login https://<服务地址> <密钥> --name <电脑名称>
pi-bridge start

每台电脑用自己的密钥,丢失或不再使用时在账号页移除那一台即可。网页版 AI 在你有多台电脑在线时按名称选择。

pi-bridge start 在终端里运行,关闭终端即断开。需要开机后自动在后台运行时,改用 pi-bridge service install。运行 pi-bridge status 查看连接状态。

运行 pi-bridge rename <电脑名称> 修改电脑名称。

运行 pi-bridge update 更新到最新版本,开机自动运行的后台服务会随之重启。有新版本时,pi-bridge status 和运行日志中会提示。

接入 Claude / ChatGPT

连接器地址对每个人都一样,里面不含密钥:

https://<服务地址>/mcp
  • Claude:在侧边栏打开 插件 → 连接器,点击 添加自定义连接器,粘贴地址。身份验证选 立即登录,OAuth 客户端保持默认。

  • ChatGPT:在侧边栏打开 插件,点击 添加自定义 MCP 服务器,连接选 服务器 URL 并粘贴地址,身份验证选 OAuth。

添加后会弹出 pi-bridge 的登录页,登录并允许访问即可。已授权的应用显示在账号页,可以随时撤销。之后在对话中告诉 AI 要操作的目录即可,例如“打开 ~/projects/blog,运行测试并修复失败的用例”。连接了多台电脑时,再告诉它用哪一台。

客户端不支持 OAuth 时,可以在账号页展开「使用带密钥的地址」生成 https://<服务地址>/<密钥>/mcp,身份验证选择「无」。

WARNING

带密钥的地址等同于密码,拿到它就能在你所有在线的电脑上执行命令。只在必要时使用,泄露后在账号页吊销。

许可证

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables remote MCP clients like ChatGPT to run shell commands and manage files on your local machine via a Cloudflare tunnel, exposing tools for file operations, search, and task management.
      7
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables ordinary ChatGPT web Chat to work directly on a local machine over a private MCP tunnel — reading and editing project files, running shell commands and tests, loading local skills, manipulating images, and driving Chrome — without spinning up a separate coding agent or additional model-generation API calls. It also supports multi-step task plans with persisted execution receipts and acceptance checks so results from real runs are returned to the conversation.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Exposes a local machine as a remotely accessible MCP server via Cloudflare Tunnel, enabling web agents to read/write files, run PowerShell, use local skills, bridge to other MCP servers, search the web, and collaborate on tasks with local agents.
      2
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables web-based AI chat clients such as Claude, ChatGPT, and Grok to operate a user's local machine through a single OAuth-gated, whitelist-protected MCP endpoint exposing tools for file editing, shell commands, search, Git, SQLite, browser automation, DevTools, background tasks, localhost service fetching, clipboard, notifications, ports, and Postman control.
      -