mcp-gh-issue-mini
2025.05.10
0
JavaScriptGitHub Issues 管理MCP 服务器开发效率
mcp-gh-issue-mini 是一个基于 MCP（Model Context Protocol）的轻量级服务器，专门用于与 GitHub Issues 进行交互。通过该服务，用户可以直接从兼容 MCP 的客户端（如 Copilot Agent）创建、搜索、更新、评论和关闭 GitHub 仓库中的问题。
View on GitHub
Overview
基本能力
产品定位
mcp-gh-issue-mini 是一个专注于 GitHub Issues 工作流的轻量级 MCP 服务器，旨在为开发者提供高效的问题管理工具。
核心功能
- 创建问题：在 GitHub 仓库中创建新问题。
- 列出问题：列出当前仓库中的开放问题。
- 获取问题详情：获取单个问题的详细信息。
- 搜索问题：使用完整的 GitHub 搜索语法搜索问题（例如
is:open label:bug "unexpected error"）。 - 更新问题：修改问题的标题、正文或状态（开放/关闭）。
- 添加评论：为问题添加评论，所有评论会自动标记为
[AI] Generated using MCP以便追踪。 - 获取评论：获取问题的所有评论。
- 关闭问题：关闭指定的问题。
适用场景
- 开发者需要快速管理 GitHub 仓库中的问题。
- 团队协作中需要自动化处理问题的工作流。
- 作为 MCP 服务器的学习或开发模板。
使用教程
使用依赖
- Node.js ≥ 18（支持 ES2022 模块）。
- 兼容 MCP 的客户端（如 GitHub Copilot Agent VS Code 扩展）。
安装教程
- 确保已安装 Node.js ≥ 18。
- 在
settings.json中配置 MCP 服务器：
// .vscode/settings.json (示例)
"mcp": {
"servers": {
"mcp-gh-issue-mini": {
"command": "npx",
"args": ["mcp-gh-issue-mini"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${env:GITHUB_PERSONAL_ACCESS_TOKEN}"
}
}
}
}
- 确保已配置 GitHub 个人访问令牌（Fine-grained Personal Access Token），并授予以下权限：
- Issues：读写权限。
- Metadata：只读权限。
调试方式
- 启动 MCP 服务器后，通过兼容的客户端（如 VS Code）进行交互。
- 使用客户端工具测试问题创建、搜索、更新等功能。
- 检查日志或客户端输出以确认操作是否成功。