GitHub Kanban MCP Server

🎯 GitHub Kanban MCP Server

📋 概要

GitHub Kanban MCP Serverは、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 - LICENSEファイルを参照してください。

🤝 コントリビューション

• このリポジトリをフォーク

• 機能ブランチを作成 (git checkout -b feature/amazing-feature)

• 変更をコミット (git commit -m '✨ feat: 素晴らしい機能を追加')

• ブランチにプッシュ (git push origin feature/amazing-feature)

• プルリクエストを作成

📮 フィードバック

問題や提案がありましたら、Issueを作成してください。