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+에서 빌드 및 테스트 완료. 14개 개발 단계 모두 완료되었으며 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개의 관리형 셸 — Windows PowerShell 5.1, PowerShell 7+, cmd; POSIX bash, zsh, sh, fish. 셸을 전환하면 AI에 표시되는 설명이 자동으로 업데이트됩니다.

• 비전 지원 read_image_file — 최대 5MiB 크기의 MCP ImageContent 블록(PNG / JPEG / GIF / WebP / BMP)을 반환하여 비전 지원 클라이언트가 픽셀을 기본적으로 볼 수 있습니다. SVG는 read_files를 통해 텍스트로 유지됩니다.

• 외부 링크 라우팅 — agentbridge.bridge.openInternalBrowser (auto / all / external)는 ChatGPT / Arena가 VS Code의 Simple Browser 내에서 열릴지 OS 기본 브라우저에서 열릴지 제어합니다. 기본값 auto는 원래의 편집기 내 경험과 일치합니다.

• 브리지 패널 — 터널 제공자 라디오 버튼, 상태 히어로, 지속적 토글, 미세 차이점이 포함된 세션 타임라인, 관리형 셸, 링크 라우팅, MCP 프롬프트 복사, routeToken 재설정을 포함한 고급 카드가 있는 활동 표시줄 뷰.

• 자동 시작 — agentbridge.bridge.persistentMode를 켜면 확장 프로그램 활성화 시 브리지가 시작됩니다.

• 클라이언트 호환성 — 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.* 네임스페이스 아래에 있습니다.

관리형 셸 및 내부 브라우저 열기에 대한 런타임 토글은 브리지 패널의 고급 카드에 있습니다.

알려진 제한 사항

• Cloudflare Quick Tunnel URL은 임시적입니다 — 재시작 시마다 변경됩니다. 안정적이고 공유 가능한 URL을 위해서는 Named Tunnel(또는 ngrok)을 사용하세요.

• 제한된 네트워크(教育网 / 엄격한 방화벽 캠퍼스 네트워크)에서 Quick Tunnel이 중단될 수 있습니다. UDP/QUIC가 종종 부분적으로 차단됩니다. 프록시에서 HTTP2/http 전송 재정의와 cloudflare.com에 대한 라우팅 규칙으로 해결할 수 있습니다. Named Tunnel이 장기적인 해결책입니다.

• Simple Browser + ChatGPT 로그인이 때때로 Cloudflare 관리형 챌린지에 부딪힙니다. 여러 번 재시도하면 일반적으로 해결됩니다. 지속되면 agentbridge.bridge.openInternalBrowser: "external"을 통해 OS 브라우저로 전환하세요.

• ChatGPT Connectors는 세션 시작 시 tools/list를 캐시합니다. MCP 도구를 추가/제거/수정하려면 사용자가 chatgpt.com → 설정 → Connectors에서 Connector를 수동으로 새로고침(또는 제거 후 다시 추가)해야 합니다. 브리지만 중지+시작하는 것으로는 충분하지 않습니다.

호환성

• VS Code 1.95+

• Node 22+

• Windows에서 검증됨. POSIX 셸 제공자는 which(1)을 통해 경로를 확인합니다.

라이선스

MIT. 전체 텍스트는 LICENSE를 참조하세요.

microsoft/vscode에서 파생된 부분은 해당 프로젝트의 MIT 라이선스가 적용됩니다. 자세한 내용은 https://github.com/microsoft/vscode를 참조하세요.