██████╗ ██╗████████╗██╗ ██╗██╗ ██╗██████╗ ██████╗ ██████╗ ██████╗ ██╗██╗ ██████╗ ████████╗
██╔════╝ ██║╚══██╔══╝██║ ██║██║ ██║██╔══██╗ ██╔════╝██╔═══██╗██╔══██╗██║██║ ██╔═══██╗╚══██╔══╝
██║ ███╗██║ ██║ ███████║██║ ██║██████╔╝ ██║ ██║ ██║██████╔╝██║██║ ██║ ██║ ██║
██║ ██║██║ ██║ ██╔══██║██║ ██║██╔══██╗ ██║ ██║ ██║██╔═══╝ ██║██║ ██║ ██║ ██║
╚██████╔╝██║ ██║ ██║ ██║╚██████╔╝██████╔╝ ╚██████╗╚██████╔╝██║ ██║███████╗╚██████╔╝ ██║
╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═════╝╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚═╝ ](https://nodejs.org/)  ](https://www.npmjs.com/package/@kud/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"]
}
}
}______________________________________________________________________
可用工具
查询
| 工具 | 说明 |
|---|---|
query | 向Copilot模型发送提示并返回响应。支持可选的型号选择和文件/图像附件。 |
发现
| 工具 | 说明 |
|---|---|
list_models | 列出所有可用的Copilot型号,包括功能、上下文窗口限制和计费倍数。 |
总计: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之间的区别。” → Callsquery随着model: "gpt-5".
“使用Claude Sonnet检查此代码并提出改进建议。” → Callsquery随着model: "claude-sonnet-4.6"代码作为提示。
“这张截图里有什么?” → Callsquery带着一个blob包含图像的附件。
“从Codex获得对该算法的第二意见。” → Callsquery随着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脚本
| 脚本 | 描述 |
|---|---|
npm run build | 将TypeScript编译为 dist/ |
npm run build:watch | 观看模式 |
npm run dev | 直接通过tsx运行(无需构建) |
npm test | 运行测试 |
npm run test:watch | 观看模式测试 |
npm run coverage | 测试覆盖率报告 |
npm run inspect | 针对内置服务器打开MCP检查器 |
npm run inspect:dev | 通过tsx打开MCP检查器 |
npm run typecheck | 不发射的类型检查 |
npm run clean | 删除 dist/ |
开发工作流程
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:
- 启动时,它生成Copilot CLI服务器,并通过stdio上的JSON-RPC连接
- 每
query调用创建一个新的Copilot会话,发送提示(带可选附件),收集响应,然后断开连接 list_models在CLI中查询可用模型——结果会自动缓存以避免速率限制- 身份验证完全由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服务器环境中避免交互式浏览器提示
______________________________________________________________________
技术栈
| 运行时 | Node.js≥20 |
| 语言 | TypeScript 5+(ESM) |
| 协议 | 模型上下文协议(MCP)1.27 |
| Copilot SDK | @github/copilot-sdk |
| 模式 | 佐德 |
| 测试 | Vitest |
| 模块系统 | ESM("type": "module") |
______________________________________________________________________
贡献
- 分叉回购
- 创建分支:
git checkout -b feat/my-change - 进行更改并添加测试
- 跑
npm run build && npm test - 打开拉取请求
______________________________________________________________________
许可证
麻省理工学院——见 许可证.
______________________________________________________________________
致谢
建在 和那个 模型上下文协议 通过Anthropic。
______________________________________________________________________
资源
______________________________________________________________________
支持
______________________________________________________________________
制作❤️ 适用于GitHub Copilot用户
⭐ 如果对您有用,请标记此仓库· ↑ 返回页首
