MCP Copilot Relay

Generate VS Code extensions from MCP (Model Context Protocol) servers by mapping discovered tools, prompts, and resources to VS Code capabilities. This NPX tool provides a web-based multi-step wizard for configuration and generates a .vsix extension package.

Features

• 🔌 Multi-Transport Support: Connect to MCP servers via stdio, SSE, or HTTP
• 🔍 Auto-Discovery: Automatically discover tools, prompts, and resources
• 🎯 Smart Mapping: Map MCP capabilities to VS Code Language Model Tools, Chat Participants, or Commands
• ⚙️ Configuration Management: Define VS Code settings for runtime configuration
• 📦 VSIX Generation: Generate complete, installable VS Code extensions
• 💾 Config Import/Export: Save and reuse configurations
• 🎨 Modern UI: Beautiful, responsive wizard interface with dark/light theme support

Quick Start

# Start the wizard (default)
npx vijay-nirmal/mcp-copilot-relay

# Build from existing config
npx vijay-nirmal/mcp-copilot-relay build --config ./my-config.json

Installation

No installation required! Use via NPX:

npx vijay-nirmal/mcp-copilot-relay

Or install globally:

npm install -g vijay-nirmal/mcp-copilot-relay
mcp-copilot-relay

Usage

1. Start the Wizard

npx vijay-nirmal/mcp-copilot-relay

This will:

1. Start the MCP proxy server on port 3000
2. Start the web UI on port 5173
3. Automatically open your browser

2. Follow the Wizard Steps

Step 1: MCP Connection

• Choose transport type (stdio, SSE, or HTTP)
• Configure connection parameters
• Test the connection
• Import from existing MCP config JSON (optional)

Step 2: Discover Capabilities

• Auto-fetch tools, prompts, and resources
• View capability cards with descriptions
• Test each capability interactively

Step 3: Map to VS Code

• Tools: Map to vscode.lm.tools (Language Model Tools) or custom commands
• Prompts: Map to Chat Participants with slash commands
• Select/unselect capabilities via checkboxes
• Edit display names and descriptions

Step 4: Extension Info

• Configure extension metadata (name, version, publisher, etc.)
• Define VS Code settings for MCP server configuration
• Map settings to MCP server environment variables/headers

Step 5: Preview & Build

• Preview and edit generated files:
  • package.json - VS Code manifest
  • extension.ts - Main entry point
  • mcp-client.ts - MCP connection logic
  • README.md - Extension documentation
• Validate configuration
• Download .vsix package
• Export configuration JSON

3. Install Generated Extension

code --install-extension path/to/your-extension-1.0.0.vsix

CLI Options

# Start server with custom port
npx vijay-nirmal/mcp-copilot-relay start --port 3001

# Don't auto-open browser
npx vijay-nirmal/mcp-copilot-relay start --no-browser

# Build from config with custom output directory