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%" /> [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/TypeScript-4.9.5-blue.svg)](https://www.typescriptlang.org/) [![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)](https://nodejs.org/) [![npm](https://img.shields.io/badge/npm-9.x-red.svg)](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)してください。