AgentBridge

将您的 VS Code 工作区的工具——文件、终端、LSP、诊断和图像——通过公共 HTTPS 隧道暴露给远程 MCP 客户端（ChatGPT Connectors、Claude Desktop、Cursor、Cline、Continue）。

中文文档 | README.zh-CN.md

状态

v0.1.0 — 首个稳定版本。 在 Windows 上使用 VS Code 1.95+ 和 Node 22+ 构建并测试。所有十四个开发阶段均已落地，并针对 ChatGPT Connectors 进行了端到端验证。

Related MCP server: vscode-mcp-server

功能

• 13 个 MCP 工具，涵盖：

  • 文件系统 — read_files、apply_patch、search_files、find_files、list_directory、read_image_file

  • 终端 — run_command、get_command_output、send_command_input

  • LSP / 诊断 — get_diagnostics、lsp

  • 桥接状态 — set_todos、report_progress

• 3 个隧道提供商 — Cloudflare Quick Tunnel（默认，零配置）、Cloudflare Named Tunnel（稳定主机名）、ngrok（保留域名）。

• 9 个受管 Shell — Windows PowerShell 5.1、PowerShell 7+、cmd；POSIX bash、zsh、sh、fish。切换 Shell 时，向 AI 显示的描述会自动更新。

• 支持视觉的 read_image_file — 返回 MCP ImageContent 块（PNG / JPEG / GIF / WebP / BMP），最大 5 MiB，使支持视觉的客户端原生看到像素。SVG 通过 read_files 保持文本形式。

• 外部链接路由 — agentbridge.bridge.openInternalBrowser（auto / all / external）控制 ChatGPT / Arena 是在 VS Code 的 Simple Browser 中打开，还是在操作系统默认浏览器中打开。默认 auto 匹配原始的编辑器内体验。

• 桥接面板 — 活动栏视图，包含隧道提供商单选按钮、状态英雄、持久切换、带有迷你差异的会话时间线，以及一个高级卡片，涵盖受管 Shell、链接路由、复制 MCP 提示和重置 routeToken。

• 自动启动 — 将 agentbridge.bridge.persistentMode 设置为 true，可在扩展激活时启动桥接。

• 客户端兼容性 — 已验证与 ChatGPT Connectors、Claude Desktop、Cursor、Cline、Continue 的兼容性。

安装

选项 A — 下载预构建的 vsix（推荐）

大多数用户不需要 Node.js 或构建工具链。只需获取预构建的 vsix 并将其安装到 VS Code 中。

1. 打开最新发布页面

2. 将 agentbridge-0.1.0.vsix 下载到您的计算机

3. 安装它：

   code --install-extension /path/to/agentbridge-0.1.0.vsix

   或者通过图形界面：VS Code → 扩展面板 → ⋯ 菜单 → "从 VSIX 安装..." → 选择下载的文件。

选项 B — 从源代码构建（适用于开发者）

需要 Node 22+ 和 npm。

git clone https://github.com/5258MF/AgentBridge.git
cd AgentBridge
npm install
npm run build

然后，将其作为开发扩展运行，或加载打包的 vsix：

# Dev mode
"Code.exe" --extensionDevelopmentPath="$PWD"

# Or package a vsix locally
npx @vscode/vsce package --skip-license --allow-missing-repository
code --install-extension agentbridge-0.1.0.vsix

选项 C — 从 VS Code 市场安装（待定）

一旦发布者注册完成，您还可以通过搜索 "AgentBridge" 直接从扩展面板安装。

隧道提供商

在 AgentBridge 面板的隧道提供商单选按钮中选择，或在 settings.json 中设置 agentbridge.bridge.tunnelProvider。

配置

所有设置都位于 agentbridge.bridge.* 命名空间下。

受管 Shell 和内部浏览器打开方式的运行时切换位于桥接面板的高级卡片上。

已知限制

• Cloudflare Quick Tunnel URL 是临时的 — 每次重启都会变化。使用 Named Tunnel（或 ngrok）以获得稳定、可共享的 URL。

• 受限网络（教育网 / 严格防火墙的校园网络）可能导致 Quick Tunnel 挂起。 UDP/QUIC 经常被半封锁。可以通过在代理中设置 HTTP2/http 传输覆盖和到 cloudflare.com 的路由规则来解决。Named Tunnel 是长期的解决方案。

• Simple Browser + ChatGPT 登录有时会遇到 Cloudflare 托管挑战。 多次重试通常可以解决；如果持续存在，请通过 agentbridge.bridge.openInternalBrowser: "external" 切换到操作系统浏览器。

• ChatGPT Connectors 在会话开始时缓存 tools/list。 添加/删除/修改 MCP 工具需要用户在 chatgpt.com → 设置 → Connectors 中手动刷新（或移除并重新添加）连接器。仅停止+启动桥接是不够的。

兼容性

• VS Code 1.95+

• Node 22+

• 已在 Windows 上验证。POSIX Shell 提供商通过 which(1) 解析路径。

许可证

MIT。完整文本见 LICENSE。

部分内容衍生自 microsoft/vscode，受该项目的 MIT 许可证保护。详情请参见 https://github.com/microsoft/vscode。