github-kanban-mcp-server

MCP.Pizza Chef: Sunwood-ai-labs

The GitHub Kanban MCP Server is a Model Context Protocol server designed to streamline task management by representing GitHub issues in a Kanban board format. It integrates fully with GitHub to provide real-time project progress visualization, automated task handling through large language models (LLMs), and interactive features such as commenting on tasks. Built with TypeScript and Node.js, this server enhances collaboration and efficiency by combining GitHub's issue tracking with AI-driven workflow automation, making it ideal for developers and teams looking to optimize project management.

Use This MCP server To

Visualize GitHub issues as Kanban boards Automate task management with LLMs Track project progress in real time Integrate GitHub issue comments into workflows Enhance team collaboration on GitHub projects

README

🎯 GitHub Kanban MCP Server

GitHub Kanban MCP Server

License: MIT TypeScript Node.js npm

📋 概要

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を作成してください。

github-kanban-mcp-server FAQ

How do I install the GitHub Kanban MCP Server?
You can install it via npm with Node.js 18.x and TypeScript 4.9.5 or later. Follow the repository's setup instructions for configuration.
Can this server handle comments on GitHub issues?
Yes, it supports commenting features integrated directly into the Kanban task management interface.
Does the server support real-time updates from GitHub?
Yes, it synchronizes GitHub issues and updates the Kanban board to reflect current project status.
Is the GitHub Kanban MCP Server compatible with multiple LLM providers?
Yes, it is designed to work with various LLMs including OpenAI, Anthropic Claude, and Google Gemini for automated task management.
What programming languages and frameworks is the server built with?
The server is developed using TypeScript and runs on Node.js 18.x, ensuring modern and scalable architecture.
How secure is the integration with GitHub?
The server uses secure OAuth tokens and scoped permissions to safely interact with GitHub APIs, following best practices for authentication.
Can I customize the Kanban board views?
Yes, the server's modular design allows customization of board layouts and task workflows to fit different project needs.
How does the server improve LLM task management?
By structuring GitHub issues into Kanban boards and enabling LLMs to automate task updates, comments, and progress tracking, it streamlines AI-assisted project workflows.