🚀 Unified Copilot MCP Bridge Server

🌟 A powerful Model Context Protocol (MCP) server that seamlessly integrates Microsoft Edge Copilot capabilities into VS Code GitHub Copilot Chat
Bridge the gap between AI services and supercharge your development workflow

---

🎯 What This Does

Transform your VS Code Copilot Chat with external AI services

This MCP server acts as a intelligent bridge between VS Code Copilot Chat and external services:

🔥 Core Integrations

1. 🌐 Microsoft Edge Copilot Integration - Forward prompts to Microsoft Edge Copilot API for enhanced AI responses
2. 📋 GitHub Context Enrichment - Fetch detailed issue and pull request information directly in chat
3. 🔧 Development Testing - Echo tool for testing and debugging MCP connections

---

🏗️ Architecture Overview

Clean, modular architecture designed for scalability

🖥️  VS Code Copilot Chat
       ↓ (via MCP stdio/HTTP)
🌉  Unified MCP Bridge Server
       ↓ (HTTP/REST APIs)
┌─────────────────┬─────────────────┬─────────────────┐
│  🌐 Edge Copilot │   📱 GitHub API  │   🔧 Echo Tool   │
│     Service     │                 │   (Testing)     │
└─────────────────┴─────────────────┴─────────────────┘

🧩 Core Components

• ⚡ MCP Server Core (lib/index.js) - Reusable library with programmatic API
• 🌐 HTTP Server (server.js) - Standalone HTTP server with web playground
• 💻 Stdio Server (server-stdio.js) - VS Code Copilot integration endpoint
• 🎮 CLI Tool (bin/unified-mcp.js) - Command-line interface for easy deployment
• 🎨 Web Playground - Browser-based testing interface at /playground

---

✨ Features & Capabilities

🛠️ Three Powerful Tools

🌐 1. copilot-edge - Microsoft Edge Copilot Bridge

Direct integration with Microsoft Edge AI

• 🚀 Forwards your prompts to Microsoft Edge Copilot API
• ⚙️ Configurable via COPILOT_EDGE_URL and COPILOT_EDGE_API_KEY
• 🎚️ Supports custom token limits with maxTokens parameter
• 🛡️ Graceful error handling with detailed API responses

📋 2. github-issue-context - GitHub Intelligence

Rich GitHub integration for development context

• 📥 Fetch complete issue/PR metadata by URL
• 🔒 Supports both public and private repositories (with token)
• 📊 Returns structured JSON data including:
  • 📝 Issue/PR title, description, state
  • 👤 Author information and timestamps
  • 🏷️ Labels, milestones, and assignees
  • 💬 Comments and review status

🔧 3. echo - Development Testing

Simple but essential testing tool

• 🔄 Simple text echo for testing MCP connectivity
• 🐛 Useful for debugging tool call workflows
• ✅ Validates JSON-RPC message formatting

---

� Multiple Deployment Modes

Flexible deployment options for any environment

• 🌐 HTTP Mode - Standalone web server with REST API and visual playground
• 💻 Stdio Mode - Direct VS Code Copilot Chat integration
• 📦 Library Mode - Import as Node.js package in your projects
• 🎮 CLI Mode - Command-line tool with flexible configuration options

🛠️ Developer Experience

Built with developers in mind

• 🎨 Visual Playground - Test tools directly in your browser at /playground
• 🔍 MCP Inspector Support - Connect with official MCP debugging tools
• ⚡ Hot Configuration - Environment-based config with .env support
• 🎭 Mock Services - Built-in mock Edge endpoint for development at /mock-edge
• 🌐 CORS Enabled - Browser-friendly for web-based integrations

---

� Quick Start Guide

📦 Step 1: Install Dependencies

Get all required packages

npm install

⚙️ Step 2: Configure Environment

Set up your API credentials

Create .env file:

GH_TOKEN=ghp_your_github_token_here
COPILOT_EDGE_URL=https://your-edge-service.com/api
COPILOT_EDGE_API_KEY=your_edge_api_key

🚀 Step 3: Start Server

Choose your deployment mode

# 🌐 HTTP mode with playground
npm run start:http

# 💻 VS Code stdio mode
npm run start:stdio

# 🎮 CLI with options
node bin/unified-mcp.js --mock-edge --port 4000

🧪 Step 4: Test in Browser

Verify everything works

Open http://localhost:3000/playground and try:

• ✅ Initialize connection
• 📋 List available tools
• 🔧 Call echo with {"text": "Hello MCP!"}

💻 Step 5: Connect to VS Code

Integrate with VS Code Copilot Chat

Add to VS Code settings.json:

{
  "github.copilot.chat.mcpServers": {
    "unified-copilot-bridge": {
      "command": "node",
      "args": ["/absolute/path/to/server-stdio.js"],
      "env": {
        "GH_TOKEN": "${env:GH_TOKEN}",
        "COPILOT_EDGE_URL": "http://127.0.0.1:3000/mock-edge",
        "COPILOT_EDGE_API_KEY": "dev"
      }
    }
  }
}

🔄 Reload VS Code and use: @unified-copilot-bridge list tools

---

📚 Complete Documentation Suite

📖 Everything you need to get started and scale to production

• 📖 INSTALLATION.md - Detailed setup instructions for all environments
• � TROUBLESHOOTING.md - Common issues and debugging guide
• � CHANGES.md - Recent fixes and improvements
• � STARTUP.md - Complete production deployment guide
• 🌐 MCP Protocol Documentation - Official MCP specification
• 🏢 Microsoft MCP Reference - Microsoft's implementation guide

---

🔗 Key Endpoints & URLs

🌐 Essential URLs for accessing your MCP server

• 🚀 HTTP MCP endpoint: http://localhost:3000/mcp
• 💓 Health check: http://localhost:3000/health
• 🎨 Web playground: http://localhost:3000/playground
• 🎭 Mock Edge service: http://localhost:3000/mock-edge
• 🏠 Homepage: http://localhost:3000/

---

🎉 Get Started Now!

🚀 Ready to supercharge your VS Code Copilot Chat?

Your Unified Copilot MCP Bridge Server is ready to:

• ✨ Enhance your development workflow
• 🌐 Connect multiple AI services
• 📋 Enrich GitHub context in chat
• 🚀 Scale from development to production

🎯 Transform your coding experience today!