GitHub Kanban MCP Server
<div align="center">
# 🎯 GitHub Kanban MCP Server
<img src="https://raw.githubusercontent.com/Sunwood-ai-labs/github-kanban-mcp-server/main/assets/header.svg" alt="GitHub Kanban MCP Server" width="100%" />
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
[](https://nodejs.org/)
[](https://www.npmjs.com/)
</div>
## 📋 概要
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)
```bash
# パッケージのインストール
npm install @sunwood-ai-labs/github-kanban-mcp-server
# GitHub CLIの認証設定
gh auth login
```
## ⚙️ 設定
MCPの設定ファイルに以下を追加:
```json
{
"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](LICENSE)ファイルを参照してください。
## 🤝 コントリビューション
1. このリポジトリをフォーク
2. 機能ブランチを作成 (`git checkout -b feature/amazing-feature`)
3. 変更をコミット (`git commit -m '✨ feat: 素晴らしい機能を追加'`)
4. ブランチにプッシュ (`git push origin feature/amazing-feature`)
5. プルリクエストを作成
## 📮 フィードバック
問題や提案がありましたら、[Issueを作成](https://github.com/sunwood-ai-labs/github-kanban-mcp-server/issues)してください。