MCP GitHub Copilot

 ██████╗ ██╗████████╗██╗  ██╗██╗   ██╗██████╗      ██████╗ ██████╗ ██████╗ ██╗██╗      ██████╗ ████████╗
██╔════╝ ██║╚══██╔══╝██║  ██║██║   ██║██╔══██╗    ██╔════╝██╔═══██╗██╔══██╗██║██║     ██╔═══██╗╚══██╔══╝
██║  ███╗██║   ██║   ███████║██║   ██║██████╔╝    ██║     ██║   ██║██████╔╝██║██║     ██║   ██║   ██║
██║   ██║██║   ██║   ██╔══██║██║   ██║██╔══██╗    ██║     ██║   ██║██╔═══╝ ██║██║     ██║   ██║   ██║
╚██████╔╝██║   ██║   ██║  ██║╚██████╔╝██████╔╝    ╚██████╗╚██████╔╝██║     ██║███████╗╚██████╔╝   ██║
 ╚═════╝ ╚═╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═════╝      ╚═════╝ ╚═════╝╚═╝     ╚═╝╚══════╝ ╚═════╝    ╚═╝

从人工智能助手处查询任何GitHub Copilot模型-不需要额外的API密钥。

特性 • 快速开始 • 安装 • 工具 • 发展

______________________________________________________________________

特性

• 🤖 查询任何副驾驶车型 --Claude、GPT-5、Codex等通过官方 @github/copilot-sdk
• 🔍 发现模型 --列出所有具有功能、上下文限制和计费倍数的可用型号
• 🚀 零额外配置 --自动使用现有的GitHub Copilot CLI凭据
• 🖼️ 图片附件 --为支持视觉的模型附加文件或base64图像
• ⚡ 现代堆栈 --TypeScript 5+、ESM、Zod模式、MCP 1.27
• 📦 MCP协议 --与Claude Desktop、Claude Code CLI、Cursor等的原生集成

______________________________________________________________________

快速开始

先决条件

• Node.js 20+
• GitHub Copilot订阅

这 @github/copilot CLI作为依赖项捆绑在一起，无需额外安装。首次运行时，它将打开一个浏览器进行自动身份验证，或者您可以通过 GITHUB_TOKEN env-var跳过提示。

安装

npm install -g @kud/mcp-github-copilot

最小克劳德代码配置

github-copilot:
  transport: stdio
  command: npx
  args:
    - -y
    - "@kud/mcp-github-copilot"

______________________________________________________________________

安装

Claude Code CLI

claude mcp add --transport stdio --scope user github-copilot \
  -- npx --yes @kud/mcp-github-copilot@latest

验证： claude mcp list 应该显示 github-copilot

Claude Desktop — macOS

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "github-copilot": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-github-copilot@latest"]
    }
  }
}

重新启动克劳德桌面。

Claude Desktop — Windows

编辑 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "github-copilot": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-github-copilot@latest"]
    }
  }
}

重新启动克劳德桌面。

Cursor

在光标设置中→ MCP → 添加服务器：

{
  "github-copilot": {
    "command": "npx",
    "args": ["--yes", "@kud/mcp-github-copilot@latest"]
  }
}

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "github-copilot": {
      "command": "npx",
      "args": ["--yes", "@kud/mcp-github-copilot@latest"]
    }
  }
}

VSCode (with Copilot)

编辑 .vscode/mcp.json 在您的工作空间中：

{
  "servers": {
    "github-copilot": {
      "type": "stdio",
      "command": "npx",
      "args": ["--yes", "@kud/mcp-github-copilot@latest"]
    }
  }
}

______________________________________________________________________

可用工具

查询

发现

总计：2个工具

______________________________________________________________________

图像附件

这 query 工具接受可选 attachments 视觉模型阵列（Claude，GPT-5+）：

文件附件 --从磁盘读取：

{
  "type": "file",
  "path": "/absolute/path/to/screenshot.png"
}

Blob附件 --内联base64数据：

{
  "type": "blob",
  "data": "",
  "mimeType": "image/png"
}

两者都支持可选 displayName 现场。

______________________________________________________________________

对话示例

“我可以访问哪些Copilot型号？” → Calls list_models，返回所有具有上下文限制和定价的模型。

“请GPT-5解释TCP和UDP之间的区别。” → Calls query 随着 model: "gpt-5".

“使用Claude Sonnet检查此代码并提出改进建议。” → Calls query 随着 model: "claude-sonnet-4.6" 代码作为提示。

“这张截图里有什么？” → Calls query 带着一个 blob 包含图像的附件。

“从Codex获得对该算法的第二意见。” → Calls query 随着 model: "gpt-5.3-codex".

______________________________________________________________________

发展

项目结构

mcp-github-copilot/
├── src/
│   └── index.ts        # MCP server — all tools in one file
├── dist/               # Compiled output (generated)
├── package.json
├── tsconfig.json
└── README.md

脚本

开发工作流程

git clone https://github.com/kud/mcp-github-copilot.git
cd mcp-github-copilot
npm install
npm run build
npm test

使用MCP检查器交互式测试工具：

npm run inspect
# Opens http://localhost:5173

______________________________________________________________________

运作原理

此MCP服务器通过官方网站连接您的AI助手和GitHub Copilot @github/copilot-sdk:

1. 启动时，它生成Copilot CLI服务器，并通过stdio上的JSON-RPC连接
2. 每 query 调用创建一个新的Copilot会话，发送提示（带可选附件），收集响应，然后断开连接
3. list_models 在CLI中查询可用模型——结果会自动缓存以避免速率限制
4. 身份验证完全由Copilot CLI处理——使用以下命令登录一次 gh auth login 而这个MCP继承了它

______________________________________________________________________

故障排除

服务器未显示在MCP列表中

• 确保安装了Copilot CLI扩展： gh extension list
• 检查Node.js版本： node --version （必须≥20）
• 尝试手动运行： npx @kud/mcp-github-copilot

身份验证错误

• 删除所有缓存的身份验证状态，让CLI在下次运行时通过浏览器重新进行身份验证
• 或设置 GITHUB_TOKEN 在MCP服务器配置中，无需浏览器提示即可进行身份验证

“找不到模型”错误

• 使用 list_models 要查看可用型号，只会显示订阅中启用的型号

MCP检查员日志

npm run inspect

______________________________________________________________________

安全最佳实践

• ✅ 没有额外的API密钥-捆绑的CLI通过浏览器OAuth或 GITHUB_TOKEN
• ✅ 永不承诺 .mcp.json （默认情况下忽略giti）
• ✅ 使用 GITHUB_TOKEN 在MCP服务器环境中避免交互式浏览器提示

______________________________________________________________________

技术栈

______________________________________________________________________

贡献

1. 分叉回购
2. 创建分支： git checkout -b feat/my-change
3. 进行更改并添加测试
4. 跑 npm run build && npm test
5. 打开拉取请求

______________________________________________________________________

许可证

麻省理工学院——见 许可证.

______________________________________________________________________

致谢

建在 和那个 模型上下文协议 通过Anthropic。

______________________________________________________________________

资源

• 模型上下文协议

______________________________________________________________________

支持

• 🐛 报告错误
• 💡 请求功能

______________________________________________________________________

制作❤️ 适用于GitHub Copilot用户

⭐ 如果对您有用，请标记此仓库· ↑ 返回页首