Github Kanban MCP Server

🚀 GitHub 問題カンバン MCP サーバー

GitHub 問題カンバン MCP サーバーは、GitHub の問題を看板形式で管理し、大規模言語モデル（LLM）を組み合わせてタスクの自動化管理を実現する Model Context Protocol（MCP）サーバーです。これにより、タスク管理の効率を大幅に向上させることができます。

🚀 クイックスタート

GitHub 問題カンバン MCP サーバーは、GitHub の問題を看板形式で管理し、LLM を利用したタスク自動化を実現するサーバーです。以下の手順でセットアップして利用を開始できます。

✨ 主な機能

• 🔄 GitHub の問題を看板形式で管理
• 🤖 LLM を駆動源としたタスクの自動化処理
• 📊 プロジェクトの進捗を可視化し、追跡可能
• 💡 コメントによるインタラクションをサポート
• 🔧 複数の状態とラベルを柔軟に設定可能

📦 インストール

1. Node.js と npm をインストールしてください（バージョン要件：Node.js >=14, npm >=6）
2. リポジトリをクローンします：

   git clone https://github.com/sunwood-ai-labs/github-kanban-mcp-server.git
   cd github-kanban-mcp-server
   

3. 依存関係をインストールします：

   npm install
   

4. サービスを起動します：

   npm start
   

📚 ドキュメント

🔧 セットアップ説明

config.json ファイルに MCP サーバーの設定を追加します。

{
  "mcpServer": {
    "host": "localhost",
    "port": 3000,
    "githubToken": "your_github_token"
  }
}

🤝 利用可能なツール

1. 問題の一覧表示

• コマンド: list_issues
• パラメータ:
  • repo: 対象のリポジトリ名（必須）
  • state: フィルタリングする状態（open/closed）（オプション、デフォルト: all）

2. 新しい問題の作成

• コマンド: create_issue
• パラメータ:
  • repo: リポジトリ名（必須）
  • title: 問題のタイトル（必須）
  • body: 問題の説明（オプション）
  • labels: ラベルのリスト（オプション）

3. 既存の問題の更新

• コマンド: update_issue
• パラメータ:
  • repo: リポジトリ名（必須）
  • issue_number: 問題の番号（必須）
  • title: 新しいタイトル（オプション）
  • body: 新しい説明（オプション）
  • state: 新しい状態（open/closed）（オプション）
  • labels: 新しいラベルのリスト（オプション）

4. コメントの追加

• コマンド: add_comment
• パラメータ:
  • repo: リポジトリ名（必須）
  • issue_number: 問題の番号（必須）
  • body: コメントの内容（必須、Markdown 形式をサポート）
  • state: 更新する状態（open/closed）（オプション）

🔧 技術詳細

プロジェクト構成

├── src/
│   ├── index.ts           # エントリーファイル
│   ├── server.ts          # サーバーの核心ロジック
│   ├── services/
│       ├── githubService.ts      # GitHub API 呼び出しの処理
│       └── mcpService.ts        # MCP プロトコルインターフェースの実装
├── interfaces/
│   ├── issue.ts           # 問題のインターフェース定義
│   └── comment.ts         # コメントのインターフェース定義
└── package.json          # プロジェクトの依存関係管理

📄 ライセンス

本プロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

🤑 貢献ガイド

1. このプロジェクトのリポジトリを Fork します。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m '✨ 追加: 簡潔で明確な機能説明')。
4. リモートブランチにプッシュします (git push origin feature/amazing-feature)。
5. Pull Request を提出します。

📬 フィードバック

問題が発生した場合や、何か提案がある場合は、Issues を通じて報告してください。