AgentBridge
AgentBridge
将您的 VS Code 工作区的工具——文件、终端、LSP、诊断和图像——通过公共 HTTPS 隧道暴露给远程 MCP 客户端(ChatGPT Connectors、Claude Desktop、Cursor、Cline、Continue)。
状态
v0.1.0 — 首个稳定版本。 在 Windows 上使用 VS Code 1.95+ 和 Node 22+ 构建并测试。所有十四个开发阶段均已落地,并针对 ChatGPT Connectors 进行了端到端验证。
Related MCP server: Portal
功能
13 个 MCP 工具,涵盖:
文件系统 —
read_files、apply_patch、search_files、find_files、list_directory、read_image_file终端 —
run_command、get_command_output、send_command_inputLSP / 诊断 —
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— 返回 MCPImageContent块(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 中。
打开最新发布页面
将
agentbridge-0.1.0.vsix下载到您的计算机安装它:
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" 直接从扩展面板安装。
隧道提供商
模式 | 公共 URL 稳定性 | 要求 |
| 临时 — 每次重启后更改 | 无 |
| 稳定主机名( | Cloudflare 账户、托管域名、隧道令牌、已发布的应用路由 |
| 保留域名( | ngrok Authtoken + 保留主机名 |
在 AgentBridge 面板的隧道提供商单选按钮中选择,或在 settings.json 中设置 agentbridge.bridge.tunnelProvider。
配置
所有设置都位于 agentbridge.bridge.* 命名空间下。
键 | 类型 | 默认值 | 说明 |
| 枚举 |
|
|
| 字符串 |
| 固定主机名(例如 |
| 整数 |
| 命名隧道路由到的本地端口 |
| 字符串 |
| 保留的 ngrok 域名(例如 |
| 字符串 |
| 绝对路径(例如 |
| 字符串 |
| 绝对路径或 PATH 可解析的名称(例如 |
| 枚举 |
|
|
| 布尔值 |
| 在扩展激活时自动启动桥接 |
受管 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。
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
- QuallaaOAuthcom.quallaa
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
The OpenRouter MCP server plugs OpenRouter into the AI tools you already use. Once connected, your assistant can pull live OpenRouter data (models, prices, your credits, rankings, and docs) and send quick test messages, all without leaving your editor.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceConverts VSCode into an MCP server that enables external clients to remotely execute VSCode internal commands, query workspace information, and interact with the editor through HTTP streaming. Built on the FastMCP framework with security controls and real-time monitoring.63MIT
- AlicenseNot gradedqualityAmaintenanceEnables MCP clients to connect to a local workspace over a public tunnel and lets them run shell commands and transfer files bidirectionally.262 npm20GPL 3.0
- AlicenseNot gradedqualityCmaintenanceBridges web-based AI agents to a local VS Code workspace over MCP Streamable HTTP, letting them inspect files, edit code, and run persistent shell commands within session-scoped boundaries. Risky, destructive, or out-of-scope operations pause for explicit human approval, with session state surviving reconnects.8 npmGPL 3.0
- AlicenseNot gradedqualityAmaintenanceExposes a running VS Code instance to AI agents via MCP, enabling file operations, LSP diagnostics, terminal commands, Git workflows, and refactoring.24MIT