Github Kanban

🚀 🎯 GitHub 問題看板 MCP サーバー

GitHub 問題看板 MCP サーバーは、GitHub の問題を利用した看板管理ツールです。大規模言語モデル（LLM）による自動タスク管理をサポートし、プロジェクトの進捗を可視化します。これは Model Context Protocol (MCP) の実装の一つです。

🚀 クイックスタート

GitHub 問題看板 MCP サーバーは、GitHub の問題を看板形式で管理し、大規模言語モデルを利用した自動化とプロジェクト進捗の可視化を実現します。以下の手順でサーバーを起動することができます。

✨ 主な機能

• 🔄 GitHub の問題を看板形式で表示します。
• 🤖 大規模言語モデルを利用した自動タスク管理をサポートします。
• 📊 プロジェクトの進捗状況を可視化します。
• 🔗 GitHub エコシステムに完全に統合されています。
• 💬 問題にコメントを追加することができます。

📦 インストール

1. リポジトリをクローンします

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

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

npm install

3. サービスを起動します

node src/index.ts

📚 ドキュメント

プロジェクト構造

kanban-server/
├── src/                    # ソースコードディレクトリ
│   ├── handlers/          # リクエストハンドラー
│   │   ├── comment-handlers.ts  # コメントリクエストを処理するモジュール
│   │   ├── issue-handlers.ts    # 問題リクエストを処理するモジュール
│   │   └── state-handlers.ts   # 状態リクエストを処理するモジュール
│   ├── models/            # データモデル定義
│   │   └── Issue.ts      # 問題データ構造を定義
│   ├── routes/           # API ルート設定
│   │   └── routes.ts     # すべての API ルートを定義
│   └── utils/            # ユーティリティ関数の集合
│       └── validator.ts  # データ検証ツール
├── package.json          # プロジェクトの依存関係とスクリプト定義
└── README.md             # プロジェクトの説明ドキュメント

設定説明

config.json ファイルに以下の設定を追加します。

{
  "github": {
    "token": "your_github_token", // あなたの GitHub アクセストークンに置き換えてください
    "owner": "your_owner_name"   // あなたのリポジトリの所有者名に置き換えてください
  },
  "mcp": {
    "endpoint": "http://localhost:3000" // MCP サービスのエンドポイントアドレス
  }
}

ツール説明

1. 問題を一覧表示する (list_issues)

指定したリポジトリ内のすべての問題を一覧表示します。 コマンド：

node list-issues.js [owner] [repo]

例：

node list-issues.js sunwood-ai-labs github-kanban-mcp-server

2. 新しい問題を作成する (create_issue)

新しい問題を作成し、タイトルと内容を指定します。 コマンド：

node create-issue.js [owner] [repo] --title "問題のタイトル" --body "問題の説明"

例：

node create-issue.js sunwood-ai-labs github-kanban-mcp-server --title "新機能リクエスト" --body "機能 X を実装してください。"

3. 既存の問題を更新する (update_issue)

指定した問題の状態、タイトル、および内容を更新します。 コマンド：

node update-issue.js [owner] [repo] [issue_number] [--state open|closed|--title 新しいタイトル |--body 新しい内容]

例：

node update-issue.js sunwood-ai-labs github-kanban-mcp-server 1 --state closed

4. コメントを追加する (add_comment)

指定した問題に新しいコメントを追加します。 コマンド：

node add-comment.js [owner] [repo] [issue_number] [--body "コメントの内容" --state open|closed]

例：

node add-comment.js sunwood-ai-labs github-kanban-mcp-server 1 --body "この機能は素晴らしいです！"

📄 ライセンス

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

🤝 コントリビューションガイド

1. このリポジトリを Fork します。
2. 新しいブランチを作成します：git checkout -b feature/your-feature-name
3. 変更をコミットします：git commit -m 'feat: 新機能の説明'
4. ブランチにプッシュします：git push origin feature/your-feature-name
5. Pull Request を送信します。

📮 フィードバック

問題が発生した場合や提案がある場合は、GitHub Issues を通じて送信してください。