Skip to main content
Glama

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: Portal

Возможности

  • 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».

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

Режим

Стабильность публичного URL

Требования

cloudflare (по умолчанию)

Временный — меняется после каждого перезапуска

Нет

cloudflare-named

Стабильное имя хоста (mcp.example.com)

Учётная запись Cloudflare, управляемый домен, Tunnel Token, опубликованный маршрут приложения

ngrok

Зарезервированный домен (you.ngrok-free.dev)

Authtoken ngrok + зарезервированное имя хоста

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

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

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

Ключ

Тип

По умолчанию

Примечания

tunnelProvider

enum

cloudflare

cloudflare / cloudflare-named / ngrok

cloudflareNamedDomain

string

""

Фиксированное имя хоста (например, mcp.example.com)

cloudflareNamedLocalPort

integer

48271

Локальный порт, на который маршрутизирует именованный туннель

ngrokDomain

string

""

Зарезервированный домен ngrok (например, you.ngrok-free.dev)

managedShell.windows

string

""

Абсолютный путь (например, C:\Program Files\PowerShell\7\pwsh.exe); пусто = по умолчанию Windows PowerShell 5.1

managedShell.unix

string

""

Абсолютный путь или имя, разрешаемое через PATH (например, /bin/zsh или bash); пусто = по умолчанию /bin/bash (или /bin/sh, если bash недоступен)

openInternalBrowser

enum

auto

auto / all / external; управляет тем, открываются ли внешние ссылки в VS Code Simple Browser или в браузере ОС по умолчанию

persistentMode

boolean

false

Автоматически запускать 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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Converts 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.
    63
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP clients to connect to a local workspace over a public tunnel and lets them run shell commands and transfer files bidirectionally.
    262 npm
    21
    GPL 3.0
  • A
    license
    Not graded
    quality
    C
    maintenance
    Bridges 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 npm
    GPL 3.0