🎯 GitHub Kanban MCP Server

📋 概要

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

🚀 特性

• 🔄 以看板形式管理 GitHub 问题
• 🤖 通过 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

获取看板上的问题列表。

输入参数:

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

2. create_issue

创建新问题。

输入参数:

• repo: GitHub 仓库名（必填）
• title: 问题标题（必填）
• emoji: 标题前附加的表情符号
• body: 问题正文
• labels: 标签数组
• assignees: 分配给用户的数组

3. update_issue

更新现有问题。

输入参数:

• repo: GitHub 仓库名（必填）
• issue_number: 问题编号（必填）
• title: 新标题
• emoji: 标题前附加的表情符号
• body: 新正文
• state: 新状态（'open', 'closed'）
• labels: 新标签数组
• assignees: 新分配数组

4. add_comment

向任务添加评论。

输入参数:

• repo: GitHub 仓库名（必填）
• issue_number: 任务（Issue）ID（必填）
• body: 评论内容（支持 Markdown 格式）（必填）
• state: 评论时更改的问题状态（'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。