# ? GitHub Kanban MCP Server
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
[](https://nodejs.org/)
[](https://www.npmjs.com/)
? 概要
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: 新しいアサインの配列
タスクにコメントを追加します。
入力パラメータ:
- 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を作成してください。
[
{
"description": "カンバンボードのissue一覧を取得します",
"inputSchema": {
"properties": {
"labels": {
"description": "フィルタリングするラベル",
"items": {
"type": "string"
},
"type": "array"
},
"path": {
"description": "Gitリポジトリの絶対パス",
"type": "string"
},
"state": {
"description": "issueの状態",
"enum": [
"open",
"closed",
"all"
],
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "list_issues"
},
{
"description": "新しいissueを作成します",
"inputSchema": {
"properties": {
"assignees": {
"description": "アサインするユーザー",
"items": {
"type": "string"
},
"type": "array"
},
"body": {
"description": "issueの本文（## の先頭には絵文字を付与して可読性を上げて）",
"type": "string"
},
"emoji": {
"description": "タイトルの先頭に付与するユニークな絵文字",
"type": "string"
},
"labels": {
"description": "issueのラベル",
"items": {
"type": "string"
},
"type": "array"
},
"path": {
"description": "Gitリポジトリの絶対パス",
"type": "string"
},
"title": {
"description": "issueのタイトル",
"type": "string"
}
},
"required": [
"title"
],
"type": "object"
},
"name": "create_issue"
},
{
"description": "既存のissueを更新します",
"inputSchema": {
"properties": {
"assignees": {
"description": "新しいアサイン",
"items": {
"type": "string"
},
"type": "array"
},
"body": {
"description": "新しい本文",
"type": "string"
},
"emoji": {
"description": "タイトルの先頭に付与する絵文字",
"type": "string"
},
"issue_number": {
"description": "issue番号",
"type": "number"
},
"labels": {
"description": "新しいラベル",
"items": {
"type": "string"
},
"type": "array"
},
"path": {
"description": "Gitリポジトリの絶対パス",
"type": "string"
},
"state": {
"description": "新しい状態",
"enum": [
"open",
"closed"
],
"type": "string"
},
"title": {
"description": "新しいタイトル",
"type": "string"
}
},
"required": [
"issue_number"
],
"type": "object"
},
"name": "update_issue"
},
{
"description": "タスクにコメントを追加",
"inputSchema": {
"properties": {
"body": {
"description": "コメントの内容（Markdown形式対応）",
"type": "string"
},
"issue_number": {
"description": "タスク（Issue）のID",
"type": "string"
},
"repo": {
"description": "GitHubリポジトリ名",
"type": "string"
},
"state": {
"description": "コメント時に変更するissueの状態（オプション）",
"enum": [
"open",
"closed"
],
"type": "string"
}
},
"required": [
"repo",
"issue_number",
"body"
],
"type": "object"
},
"name": "add_comment"
}
]