MCP Gh Issue Mini

mcp gh问题迷你版

用于管理的生产就绪MCP（模型上下文协议）服务器 GitHub问题 具有强大的身份验证和模块化架构。

直接从兼容MCP的客户端（如Claude Code）在任何存储库中轻松创建、搜索、更新、评论和关闭问题。

✨ 特性

核心功能

• 创建 任何GitHub存储库中的新问题
• 列表 过滤的未决问题
• 获取 详细问题信息
• 搜索 完整GitHub查询语法的问题(is:open label:bug "error")
• 更新 问题（标题、正文、州）
• 添加评论 具有自动MCP可追溯性
• 检索 所有问题评论
• 关闭 问题

高级功能

• 🔐 双重身份验证：PAT+GitHub CLI回退
• 🏗️ 模块化架构：明确区分关注点
• 📝 综合录井：4级调试系统
• ✅ 全面测试覆盖：68.64%，29项测试通过
• 🚀 零配置：与合作 npx 立即

🛠️ 快速开始

即时设置（推荐）

# Works immediately with GitHub CLI auth
gh auth login
npx mcp-gh-issue-mini

VS代码MCP配置

{
  "mcp": {
    "servers": {
      "mcp-gh-issue-mini": {
        "command": "npx",
        "args": ["mcp-gh-issue-mini"],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${env:GITHUB_PERSONAL_ACCESS_TOKEN}"
        }
      }
    }
  }
}

可选的：添加 "DEBUG_MCP_GH_ISSUE": "true" 转到env以获取详细日志记录

🔐 验证系统

推荐：GitHub CLI身份验证

gh auth login  # One-time setup
npx mcp-gh-issue-mini  # Works immediately

替代方案：个人访问令牌

设置环境变量 GITHUB_PERSONAL_ACCESS_TOKEN 如果您更喜欢PAT身份验证。

所需PAT权限：

调试模式

DEBUG_MCP_GH_ISSUE=true npx mcp-gh-issue-mini

📋 可用工具

1. create_issue -创建新的GitHub问题
2. list_open_issues -列出存储库的未决问题
3. get_issue -获取详细的问题信息
4. update_issue -更新问题标题、正文或状态
5. close_issue -关闭问题
6. search_issues -GitHub查询语法的搜索问题
7. add_issue_comment -向问题添加评论
8. get_issue_comments -检索所有问题评论

🏗️ 建筑

模块化设计

src/
├── api/           # GitHub API integration
├── auth/          # Dual authentication system  
├── utils/         # Logging & helper functions
├── test/          # Comprehensive test suite
└── index.ts       # MCP server entry point

关键组件

• 统一的GitHub API客户端：API综合处理
• 智能身份验证：自动PAT→ CLI回退
• 可配置日志记录：错误/警告/信息/调试级别
• 完全类型安全：完整的TypeScript定义

📊 质量指标

• ✅ 29项测试通过 （0次失败）
• ✅ 68.64%的代码覆盖率
• ✅ 0个安全漏洞
• ✅ 构建时间\<5s
• ✅ 8.6 kB封装大小

🚀 安装和配电

NPM包

# Direct usage
npx mcp-gh-issue-mini

# Install globally  
npm install -g mcp-gh-issue-mini

开发设置

git clone https://github.com/y-hirakaw/mcp-gh-issue-mini.git
cd mcp-gh-issue-mini
npm install
npm run build
npm test

💡 为什么选择此服务器？

生产准备就绪：强大的错误处理、全面的日志记录、双重身份验证 开发者友好：完整的TypeScript，广泛的测试，清晰的架构\ 零依赖：占用空间最小，只有基本依赖关系 真实世界测试：通过实际的GitHub存储库和各种身份验证场景进行验证

非常适合学习MCP开发模式或将GitHub Issues集成到AI工作流程中。

______________________________________________________________________

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件。

🤝 贡献

欢迎提交Bug报告、建议和PR！这个项目遵循标准的开源贡献实践。