🎯 GitHub 看板 MCP 服务器

📋 概要

GitHub 看板 MCP 服务器是一个用于以看板形式管理 GitHub issue，并提高 LLM 任务管理效率的 Model Context Protocol (MCP) 服务器。

🚀 特征

• 🔄 以看板形式管理 GitHub issue
• 🤖 LLM 自动任务管理
• 📊 项目进度可视化
• 🔗 与 GitHub 完全集成
• 💬 任务评论功能

📁 项目结构

kanban-server/
├── src/                    # 源代码目录
│   ├── handlers/          # 请求处理程序
│   │   ├── comment-handlers.ts  # 评论相关处理
│   │   ├── issue-handlers.ts    # Issue 相关处理
│   │   ├── label-handlers.ts    # 标签相关处理
│   │   └── tool-handlers.ts     # 工具请求处理
│   ├── schemas/           # 输入模式定义
│   │   ├── comment-schemas.ts   # 评论相关模式
│   │   └── issue-schemas.ts     # Issue 相关模式
│   ├── utils/             # 实用函数
│   │   ├── error-handler.ts     # 错误处理
│   │   └── exec.ts             # 命令执行相关
│   ├── server.ts          # MCP 服务器的实现
│   └── types.ts           # 类型定义
├── docs/                  # 文档
│   └── v0.2.0/           # 版本特定文档
└── assets/               # 资源文件

🛠️ 安装

前提条件

• Node.js 18.x 或更高版本
• npm 9.x 或更高版本
• GitHub CLI (gh)

# 安装软件包
npm install @sunwood-ai-labs/github-kanban-mcp-server

# GitHub CLI 身份验证设置
gh auth login

⚙️ 配置

将以下内容添加到 MCP 配置文件：

{
  "mcpServers": {
    "github-kanban": {
      "command": "github-kanban-mcp-server"
    }
  }
}

🔧 使用可能なツール

1. list_issues

获取看板的 issue 列表。

输入参数:

• repo: GitHub 仓库名称（必需）
• state: issue 状态（'open', 'closed', 'all'）
• labels: 用于过滤的标签数组

2. create_issue

创建新的 issue。

输入参数:

• repo: GitHub 仓库名称（必需）
• title: issue 标题（必需）
• emoji: 添加到标题开头的表情符号
• body: issue 正文
• labels: 标签数组
• assignees: 要分配的用户的数组

3. update_issue

更新现有 issue。

输入参数:

• repo: GitHub 仓库名称（必需）
• issue_number: issue 编号（必需）
• title: 新标题
• emoji: 添加到标题开头的表情符号
• body: 新正文
• state: 新状态（'open', 'closed'）
• labels: 新标签数组
• assignees: 新分配的数组

4. add_comment

向任务添加评论。

输入参数:

• repo: GitHub 仓库名称（必需）
• issue_number: 任务（Issue）的 ID（必需）
• body: 评论内容（支持 Markdown 格式）（必需）
• state: 评论时要更改的 issue 状态（'open', 'closed'）

📝 许可证

MIT 许可证 - 请参阅 LICENSE 文件。

🤝 贡献

1. Fork 此仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '✨ feat: 添加了很棒的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建拉取请求

📮 反馈

如果您有任何问题或建议，请创建 Issue。