AgentBridge

Предоставьте инструменты вашего рабочего пространства VS Code — файлы, терминал, LSP, диагностику и изображения — удалённым MCP-клиентам (ChatGPT Connectors, Claude Desktop, Cursor, Cline, Continue) через публичный HTTPS-туннель.

Китайская документация | README.zh-CN.md

Статус

v0.1.0 — первый стабильный релиз. Собрано и протестировано на Windows с VS Code 1.95+ и Node 22+. Все четырнадцать этапов разработки реализованы и проверены end-to-end с 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

  • Состояние Bridge — set_todos, report_progress

• 3 провайдера туннелей — Cloudflare Quick Tunnel (по умолчанию, без настройки), Cloudflare Named Tunnel (стабильное имя хоста), ngrok (зарезервированный домен).

• 9 управляемых оболочек — Windows PowerShell 5.1, PowerShell 7+, cmd; POSIX bash, zsh, sh, fish. Описание, показываемое ИИ, автоматически обновляется при переключении оболочек.

• С поддержкой изображений read_image_file — возвращает MCP-блоки ImageContent (PNG / JPEG / GIF / WebP / BMP) размером до 5 МиБ, поэтому клиенты с поддержкой изображений видят пиксели нативно. SVG остаётся текстом через read_files.

• Маршрутизация внешних ссылок — agentbridge.bridge.openInternalBrowser (auto / all / external) управляет тем, открываются ли ChatGPT / Arena внутри Simple Browser в VS Code или в браузере ОС по умолчанию. Значение по умолчанию auto повторяет исходное поведение внутри редактора.

• Панель Bridge — представление в Activity Bar с переключателем провайдера туннеля, крупным блоком статуса, постоянным переключателем, хронологией сессий с мини-диффами и расширенной карточкой, охватывающей управляемую оболочку, маршрутизацию ссылок, copy-MCP-prompt и сброс routeToken.

• Автозапуск — включите agentbridge.bridge.persistentMode, чтобы поднимать Bridge при активации расширения.

• Совместимость с клиентами — проверено с 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 → панель Extensions → меню ⋯ → «Install from 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 Marketplace (ожидается)

После завершения регистрации издателя вы также сможете установить расширение прямо из панели Extensions, выполнив поиск по запросу «AgentBridge».

Провайдеры туннелей

Выберите нужный вариант в радиопереключателе провайдера туннеля на панели AgentBridge или задайте agentbridge.bridge.tunnelProvider в settings.json.

Конфигурация

Все настройки находятся в пространстве имён agentbridge.bridge.*.

Переключатели времени выполнения для управляемой оболочки и открытия во внутреннем браузере находятся на расширенной карточке панели Bridge.

Известные ограничения

• URL Cloudflare Quick Tunnel непостоянный — меняется при каждом перезапуске. Используйте 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-инструментов требует, чтобы пользователь вручную обновил (Refresh) или удалил и заново добавил (Remove + re-add) коннектор в chatgpt.com → Settings → Connectors. Просто остановить и запустить Bridge недостаточно.

Совместимость

• VS Code 1.95+

• Node 22+

• Проверено на Windows. POSIX-провайдеры оболочек разрешают пути через which(1).

Лицензия

MIT. Полный текст см. в LICENSE.

Части, производные от microsoft/vscode, покрываются лицензией MIT этого проекта. Подробности см. на https://github.com/microsoft/vscode.