MCP Kanban Memory

MCP カンバンタスク管理

AI 主導の開発に向けた、カンバン方式のタスク管理状態を提供する MCP ツールセットです。ほかのタスク管理 MCP ツールと似ていますが、カンバン方式のタスク管理システムが持つ構造、ルール、可視性が追加されています。

主な考え方は、計画セッションと実行セッションの両方で、AI エージェントに作業をタスクとして記録し、カンバンボードに保存させることです。

主な特長

• 列の容量／仕掛かり中の作業の上限
• 組み込みデータベース（SQLite）
• ワークフローの進捗を確認し、タスクを手動で変更できるウェブ UI
• ワークフローの開始と再開に使える、定義済みのプロンプト

使用方法

MCP プロンプトを使って、プロジェクトを開始するか、プロジェクトを進めます。 または、LLM アシスタントにカンバンボードを作成して計画を記録するよう依頼します。次のセッションで作業を進めるには、特定のカンバンボードを見つけて作業を再開するようアシスタントに依頼します。

インストール

このリポジトリをクローンしてから、次を実行します。

npm ci --prefix shared/db
npm ci --prefix mcp-server
npm run build --prefix shared/db
npm run build --prefix mcp-server

次に、MCP サーバーの設定を MCP クライアント（例：Claude Desktop）に追加します。

"mcpServers": {
    "kanban-mcp": {
        "command": "node",
        "args": [
            "/path/to/repo/mcp-server/dist/server.js"
        ],
        "env": {
            "MCP_KANBAN_DB_FOLDER_PATH": "/path/to/db"
        }
    }
}

/path/to/repo は、クローンしたリポジトリの場所に置き換えてください。

/path/to/db は、DB ファイルを格納するフォルダーに置き換えてください。読み書きが可能であれば、どのフォルダーでも使用できます。存在しない場合は作成されます。

Docker を使用したインストール

Docker イメージをビルドします。

docker build -t mcp/mcp-kanban .

次に、MCP サーバーの設定を MCP クライアント（例：Claude Desktop）に追加します。

"mcpServers": {
    "kanban-mcp": {
        "command": "docker",
        "args": [
            "run",
            "--rm",
            "-i",
            "-v",
            "/path/to/db:/mcp",
            "mcp/mcp-kanban"
        ]
    }
}

/path/to/db は、DB ファイルを格納するフォルダーに置き換えてください。読み書きが可能であれば、どのフォルダーでも使用できます。存在しない場合は作成されます。

ウェブ UI の使用

web-ui と web-server をビルドします。

npm ci --prefix shared/db
npm run build --prefix shared/db

npm ci --prefix web-ui
npm ci --prefix web-server
npm run build --prefix web-ui
npm run build --prefix web-server

web-server を実行します。

MCP_KANBAN_DB_FOLDER_PATH=/path/to/db npm run start --prefix web-server

ブラウザーで http://localhost:8221 を開きます。

API

ツール

• create-kanban-board

  • タスクを計画し、進捗を管理するための新しいカンバンボードを作成します。
  • 入力：
    • name（string）：ボードの名前
    • projectGoal（string）：プロジェクトの目標。

• add-task-to-board

  • カンバンボードの最初の列（to-do）に新しいタスクを追加します。
  • 入力：
    • boardId（string）：タスクの追加先となるボードの ID
    • title（string）：タスクのタイトル
    • content（string）：Markdown 形式のタスク内容

• move-task

  • WIP の上限を守りながら、タスクを別の列に移動します。
  • 入力：
    • taskId（string）：移動するタスクの ID
    • targetColumnId（string）：タスクの移動先となる列の ID
    • reason（string、任意）：タスクを移動する理由

• delete-task

  • タスクを削除します。
  • 入力：
    • taskId（string）：削除するタスクの ID

• get-board-info

  • 列とタスクを含む、カンバンボードの全情報を取得します。
  • 入力：
    • boardId（string）：情報を取得するボードの ID
  • 列とタスクを含む、ボードの詳細情報を返します。

• get-task-info

  • 内容を含む、タスクの全情報を取得します。
  • 入力：
    • taskId（string）：情報を取得するタスクの ID
  • 内容を含む、タスクの詳細情報を返します。

• list-boards

  • データベース内のすべてのカンバンボードを一覧表示します。
  • 入力：なし
  • 名前、作成日時、目標とともに、データベース内のすべてのボードの一覧を返します。

プロンプト

• create-kanban-based-project

  • プロジェクト用のカンバンボードを作成し、プロジェクトをタスクに分割するための質問をして、タスクをボードに追加します。
  • 入力：
    • description（string）：プロジェクトの説明

• make-progress-on-a-project

  • 既存のプロジェクトのカンバンボードを見つけ、次のタスクを選んで作業することで、プロジェクトを進めます。
  • 入力：
    • description（string）：プロジェクトの説明