🎯 GitHub Kanban MCP Server

📋 概述

GitHub Kanban MCP 服务是一款 Model Context Protocol（MCP）服务，可通过看板形式管理 GitHub issue，从而提高大模型的任务管理效率。

🚀 特点

• 🔄 以看板形式管理 GitHub issue
• 🤖 通过大模型自动管理任务
• 📊 可视化项目进度
• 🔗 与 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——请参阅 LICENSE 文件。

🤝 贡献

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

📮 反馈

如有问题或建议，请创建 Issue。