GitHub Kanban MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Integrates with Git repositories to access and manage project issues, allowing operation on repositories through local paths.

  • Provides tools for managing GitHub issues in a Kanban board format, including listing, creating, and updating issues, applying labels, assigning users, and adding comments to tasks. Enables efficient task management and project visualization through GitHub's issue tracking system.

  • Supports Markdown formatting in issue bodies and comments, enabling rich text formatting for task descriptions and communications.

🎯 GitHub Kanban MCP Server

📋 Overview

GitHub Kanban MCP Server is a Model Context Protocol (MCP) server for managing GitHub issues in Kanban board format and streamlining LLM task management.

🚀 Features

  • 🔄 Manage GitHub issues in Kanban format
  • 🤖 Automated Task Management with LLM
  • 📊 Visualize project progress
  • 🔗 Full integration with GitHub
  • 💬 Comments on tasks

📁 Project Structure

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/ # アセットファイル

🛠️ Installation

Prerequisites

  • Node.js 18.x or higher
  • npm 9.x or higher
  • GitHub CLI (gh)
# パッケージのインストール npm install @sunwood-ai-labs/github-kanban-mcp-server # GitHub CLIの認証設定 gh auth login

⚙️ Settings

Add the following to your MCP config file:

{ "mcpServers": { "github-kanban": { "command": "github-kanban-mcp-server" } } }

🔧 Available Tools

1. list_issues

Gets a list of issues on the Kanban board.

Input parameters:

  • repo : GitHub repository name (required)
  • state : The state of the issue ('open', 'closed', 'all').
  • labels : An array of labels to filter by.

2. create_issue

Create a new issue.

Input parameters:

  • repo : GitHub repository name (required)
  • title : Title of the issue (required)
  • emoji : Emoji to be added at the beginning of the title
  • body : The body of the issue
  • labels : An array of labels
  • assignees : Array of users to assign

3. update_issue

Update an existing issue.

Input parameters:

  • repo : GitHub repository name (required)
  • issue_number : Issue number (required)
  • title : New title
  • emoji : Emoji to be added at the beginning of the title
  • body : new body
  • state : The new state ('open', 'closed').
  • labels : An array of new labels
  • assignees : Array of new assignments

4. add_comment

Add a comment to the task.

Input parameters:

  • repo : GitHub repository name (required)
  • issue_number : ID of the task (issue) (required)
  • body : Comment content (Markdown format supported) (required)
  • state : The state of the issue to change when commenting ('open', 'closed')

📝 License

MIT License - See the LICENSE file.

🤝 Contributions

  1. Fork this repository
  2. Create a feature branch ( git checkout -b feature/amazing-feature )
  3. Commit your changes ( git commit -m '✨ feat: 素晴らしい機能を追加' )
  4. Push to the branch ( git push origin feature/amazing-feature )
  5. Create a pull request

📮 Feedback

If you have any problems or suggestions, please create an issue .

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

A Model Context Protocol server that enables efficient management of GitHub issues in a Kanban board format, allowing LLMs to automate task management through GitHub integration.

  1. 📋 概要
    1. 🚀 特徴
      1. 📁 プロジェクト構造
        1. 🛠️ インストール
          1. 前提条件
        2. ⚙️ 設定
          1. 🔧 使用可能なツール
            1. 1. list_issues
            2. 2. create_issue
            3. 3. update_issue
            4. 4. add_comment
          2. 📝 ライセンス
            1. 🤝 コントリビューション
              1. 📮 フィードバック
                ID: jpb24ly92c