pi-bridge
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
pi-bridge
pi-bridge 让 Claude 和 ChatGPT 网页版调用你电脑上的 Pi:运行命令、读写文件,以及使用 Pi 已安装的 Skills、扩展和 MCP 服务器。模型仍是网页版里的那个,本机不额外调用模型。
它由两部分组成:部署在 Cloudflare Workers 上的服务端,提供网页版接入用的 MCP 地址;运行在电脑上的 pi-bridge 命令行,负责连接服务端并在本机执行。一个服务端可以供多人使用,每人可以连接多台电脑。
部署服务端
需要一个 Cloudflare 账号并启用 R2,免费套餐即可。两种方式任选其一。
一键部署
按页面提示连接 GitHub 并填写 ADMIN_KEY(登录管理页的密钥,请设置一串足够长的随机字符)。Cloudflare 会在你的 GitHub 账号下创建一个新仓库并完成部署。这个仓库不会随本项目自动更新,升级时需要手动合并改动;想方便升级,请使用下面的方式。
Fork 后部署
在 Cloudflare 控制台打开 Workers & Pages → Create → Import a repository,选择你的 Fork。
在构建设置中把 Root directory 设为
packages/server,其余保持默认,部署。打开这个 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。管理员看不到用户的密钥。
从旧版本升级时,每位老用户原来的密钥会变成一个「迁移的旧密钥」,已登录的电脑和已配置的连接器继续可用。老用户还没有登录账号,管理页会标出「未设置登录账号」,点「设置登录账号」生成用户名和初始密码。登录后账号页会提示更换旧密钥。
配置项 | 作用 | 默认值 |
| 登录管理页的密钥 | 无,必须设置 |
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://<服务地址>/mcpClaude:在侧边栏打开 插件 → 连接器,点击 添加自定义连接器,粘贴地址。身份验证选 立即登录,OAuth 客户端保持默认。
ChatGPT:在侧边栏打开 插件,点击 添加自定义 MCP 服务器,连接选 服务器 URL 并粘贴地址,身份验证选 OAuth。
添加后会弹出 pi-bridge 的登录页,登录并允许访问即可。已授权的应用显示在账号页,可以随时撤销。之后在对话中告诉 AI 要操作的目录即可,例如“打开 ~/projects/blog,运行测试并修复失败的用例”。连接了多台电脑时,再告诉它用哪一台。
客户端不支持 OAuth 时,可以在账号页展开「使用带密钥的地址」生成 https://<服务地址>/<密钥>/mcp,身份验证选择「无」。
带密钥的地址等同于密码,拿到它就能在你所有在线的电脑上执行命令。只在必要时使用,泄露后在账号页吊销。
许可证
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Zero-dependency Cloudflare Worker gateway turning websites and REST APIs into MCP tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.7MIT
- FlicenseNot gradedqualityCmaintenanceEnables 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.-
- AlicenseNot gradedqualityCmaintenanceExposes 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.2MIT
- FlicenseNot gradedqualityAmaintenanceEnables 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.-