Copilot MCP Bridge

A lightweight VS Code extension and Model Context Protocol (MCP) server that exposes GitHub Copilot language models (via the official vscode.lm API) to autonomous AI agents, multi-agent frameworks, and command-line tools — with automatic Markdown logging and history indexing.

Why Copilot MCP Bridge?

• Multi-Agent Collaboration: Allow external agents (such as Google Antigravity, Claude Desktop, Cursor, or custom subagents) to delegate tasks to GitHub Copilot as a specialized subagent.
• Cross-Model Validation: Use Copilot for code review, refactoring, edge-case analysis, and unit test generation alongside your primary agent.
• 100% Official & Native: Built on VS Code's official Language Model API (vscode.lm). No unofficial reverse-engineered API tokens or Terms of Service violations.
• Dual-Mode MCP Transport: Connect either directly via local HTTP/SSE (http://127.0.0.1:9595/sse) or via the zero-latency Stdio Proxy bridge.
• Full Traceability: Every interaction and delegated task is automatically logged to .copilot-mcp/logs/ with an interactive summary index in .copilot-mcp/HISTORY.md.

Architecture

┌────────────────────────────────────────────────────────────────────────┐
│                        VS Code / VS Code Insiders                      │
│                                                                        │
│  ┌────────────────────────┐           ┌─────────────────────────────┐  │
│  │     GitHub Copilot     │           │     copilot-mcp-bridge      │  │
│  │ (Claude 3.5, GPT-4o,   │ vscode.lm │       (VS Code Extension)   │  │
│  │  o1, Auto, etc.)       │◄──────────┤ - McpServer (@modelcontext) │  │
│  └────────────────────────┘           │ - Local SSE Server (:9595)  │  │
│                                       │ - Automated Markdown Logger │  │
│                                       └──────────────▲──────────────┘  │
└──────────────────────────────────────────────────────┼─────────────────┘
                                                       │ SSE / HTTP / Stdio
                                                       ▼
                                        ┌─────────────────────────────┐
                                        │        MCP Client           │
                                        │  (Antigravity, Claude,      │
                                        │   Cursor, Terminal CLI)     │
                                        └─────────────────────────────┘

Prerequisites

1. VS Code or VS Code Insiders (v1.90.0 or later).
2. GitHub Copilot and GitHub Copilot Chat extensions installed and authenticated.
3. Node.js (v18 or later).

Installation & Setup

1. Clone or Symlink to Extensions Directory

Clone the repository and link it to your VS Code extensions folder:

git clone https://github.com/DevGiov/copilot-mcp-bridge.git
cd copilot-mcp-bridge

# Install dependencies and build TypeScript
npm install
npm run build

# Link to VS Code (or ~/.vscode-insiders/extensions for Insiders)
ln -sfn "$(pwd)" ~/.vscode/extensions/copilot-mcp-bridge
# Or for VS Code Insiders:
# ln -sfn "$(pwd)" ~/.vscode-insiders/extensions/copilot-mcp-bridge

2. Reload VS Code

In VS Code, open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P), and run:

Developer: Reload Window

Once reloaded, you will see $(hubot) Copilot MCP :9595 in the bottom right of the status bar.

[!NOTE] One-Time Permission Prompt: The first time an MCP client makes a request to Copilot, VS Code will display a notification: "Extension Copilot MCP Bridge wants to access language model... [Allow / Don't Allow]". Click Allow once to grant permanent access.

Available MCP Tools

1. copilot_chat

Sends an instruction, task, or question to GitHub Copilot, captures the response, and automatically records the log in Markdown.

2. copilot_list_models

Lists all language models provided by your GitHub Copilot subscription in VS Code (with IDs, families, and context token limits).

3. copilot_get_editor_context

Returns real-time editor state from the active VS Code window:

• Active file path
• Selected text (if any)
• Cursor position
• Diagnostics and linter problems (warnings/errors)

Automatic Markdown Logging

Every conversation or delegated task is saved automatically to the workspace:

• Detailed Task Log: .copilot-mcp/logs/YYYY-MM-DD_HH-mm-ss_<task_name>.md
  • Includes timestamp, model used, active file, system prompt, full prompt, and response.
• History Index: .copilot-mcp/HISTORY.md
  • A persistent, chronological table linking to each individual log file for easy review.

Quick CLI Usage

A standalone CLI script is included in bin/copilot-cli.js:

# List available Copilot models
./bin/copilot-cli.js -l

# Send a prompt
./bin/copilot-cli.js "Explain closures in JavaScript in 2 bullet points"

# Delegate a task with a system prompt and custom task name
./bin/copilot-cli.js -t "auth_review" -s "You are a senior security engineer." "Review the auth middleware in src/auth.ts"

# Include active VS Code editor file automatically
./bin/copilot-cli.js -f -t "write_unit_tests" "Write unit tests for this file"

Client Configuration Examples

Antigravity (mcp_config.json)

Add the server to ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "copilot": {
      "command": "node",
      "args": [
        "/path/to/copilot-mcp-bridge/bin/mcp-stdio-proxy.js"
      ],
      "env": {
        "COPILOT_MCP_PORT": "9595"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "copilot": {
      "command": "node",
      "args": [
        "/path/to/copilot-mcp-bridge/bin/mcp-stdio-proxy.js"
      ],
      "env": {
        "COPILOT_MCP_PORT": "9595"
      }
    }
  }
}

Direct SSE Connection (Streamable HTTP)

Any MCP client supporting SSE can connect directly to:

http://127.0.0.1:9595/sse

Development & Scripts

# Build TypeScript
npm run build

# Watch mode
npm run watch

# Run Stdio Proxy directly
node bin/mcp-stdio-proxy.js

License

MIT License © 2026 DevGiov