What is Github Kanban Mcp Server

GitHub Kanban MCP Server is a Model Context Protocol (MCP) server designed to manage GitHub issues in a Kanban board format, enhancing task management efficiency with the help of LLM.

Use cases

Use cases for the GitHub Kanban MCP Server include project management for software development, task tracking in collaborative environments, and enhancing productivity by visualizing workflows.

How to use

To use the GitHub Kanban MCP Server, install it via npm, authenticate with GitHub CLI, and configure the MCP settings to include the server command. You can then utilize various tools to manage issues, create new ones, update existing ones, and add comments.

Key features

Key features include management of GitHub issues in a Kanban format, automated task management using LLM, project progress visualization, complete integration with GitHub, and a commenting feature for tasks.

Where to use

undefined

🎯 GitHub Kanban MCP Server

📋 概要

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: 新しいアサインの配列

4. add_comment

タスクにコメントを追加します。

入力パラメータ:

• repo: GitHubリポジトリ名（必須）
• issue_number: タスク（Issue）のID（必須）
• body: コメントの内容（Markdown形式対応）（必須）
• state: コメント時に変更するissueの状態（‘open’, ‘closed’）

📝 ライセンス

MIT License - LICENSEファイルを参照してください。

🤝 コントリビューション

1. このリポジトリをフォーク
2. 機能ブランチを作成 (git checkout -b feature/amazing-feature)
3. 変更をコミット (git commit -m '✨ feat: 素晴らしい機能を追加')
4. ブランチにプッシュ (git push origin feature/amazing-feature)
5. プルリクエストを作成

📮 フィードバック

問題や提案がありましたら、Issueを作成してください。