Kanban MCP

🚀 MCP 看板

MCP ツールセットで、複雑な多セッションワークフローの AI エージェントに内部タスク管理状態を提供します。他の記憶 MCP ツールに似ていますが、カンバン式タスク管理システムの構造、ルール、可視性が追加されています。

主要な考え方は、AI エージェントに、計画会議や実行会議などの作業をカンバンに記録し保存するように指示することです。

🚀 クイックスタート

MCP 看板は、複雑な多セッションワークフローにおける AI エージェントのタスク管理を支援するツールです。以下に、基本的な使い方やインストール方法を説明します。

✨ 主な機能

• 列容量 / 作業進捗制限
• 組み込みデータベース (SQLite)
• 作業進捗の観察とタスクの手動修正ができる Web UI
• ワークフローの開始と再開のための事前定義されたプロンプト

📦 インストール

通常のインストール

このリポジトリをクローンし、以下のコマンドを実行します。

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 ファイルを含めたいフォルダに置き換えてください。これは読み書き権限のある任意のフォルダです。

💻 使用例

基本的な使用法

MCP プロンプトを使用してプロジェクトを開始するか、既存のプロジェクトで進捗を得ます。または、大規模言語モデルのアシスタントにカンバンを作成してその計画を記録させます。後続の会議で作業を続けるには、アシスタントに特定のカンバンを見つけて作業を再開するように指示します。

高度な使用法

Web UI の使用

Web インターフェースと Web サーバーをビルドします。

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 サーバーを実行します。

node server.js

その後、ブラウザで http://localhost:3000 にアクセスします。

API ツールの使用

• カンバンの作成：POST /kanban を使用して新しいカンバンを作成します。
• すべてのカンバンの取得：GET /kanban を使用してすべてのカンバンのリストを取得します。
• タスク状態の更新：PUT /kanban/{boardId}/task/{taskId} を使用して特定のタスクの状態を更新します。

また、以下のような操作も可能です。

• カンバンを基にしたプロジェクトの作成：カンバンを作成し、問題を提起してプロジェクトをタスクに分解し、カンバンに追加します。
• 既存プロジェクトでの進捗取得：カンバンを見つけ、次のタスクを選択して処理します。