🔄 Kanban MCP

🔄 Kanban MCP

Kanban MCP プロジェクトへようこそ！🎉 このプロジェクトは、Planka のカンバンボードを Cursor の Machine Control Protocol（MCP）と連携させ、Claude などの AI アシスタントがカンバンボードを管理できるようにします。

🤔 Kanban MCP とは？

Kanban MCP は、Planka（オープンソースのカンバンボード）と Cursor の Machine Control Protocol をつなぐブリッジです。これにより、Claude などの AI アシスタントは次の操作を行えます。

• 📋 プロジェクト、ボード、リスト、カードの表示と管理
• ✅ タスクの作成と更新
• 💬 カードへのコメントの追加
• 🔄 リスト間でのカードの移動
• ⏱️ タスクに費やした時間の記録
• 🚀 その他にもさまざまな操作が可能です！

この連携により、Claude に開発タスクの管理、進捗の追跡、作業の整理を依頼できるシームレスなワークフローが実現します。

🚦 クイックスタート

📋 前提条件

• 🐳 Planka の実行に必要な Docker
• 🔄 リポジトリのクローンに必要な Git
• 🟢 開発用の Node.js（バージョン 18 以上）と npm

📥 インストール

1. このリポジトリをクローンします。

git clone https://github.com/bradrisse/kanban-mcp.git
cd kanban-mcp

2. 依存関係をインストールし、TypeScript コードをビルドします。

npm install
npm run build

3. Planka コンテナを起動します。

npm run up

4. Planka のカンバンボードにアクセスします。

   • デフォルト URL： http://localhost:3333
   • デフォルトの認証情報：
     • メールアドレス： [email protected]
     • パスワード： demo

5. MCP サーバーを使用するよう Cursor を設定します。

   • Cursor で「Settings > Features > MCP」に移動します。
   • 次の設定で新しい MCP サーバーを追加します。

   {
     "mcpServers": {
       "kanban": {
         "command": "node",
         "args": ["/path/to/kanban-mcp/dist/index.js"],
         "env": {
           "PLANKA_BASE_URL": "http://localhost:3333",
           "PLANKA_AGENT_EMAIL": "[email protected]",
           "PLANKA_AGENT_PASSWORD": "demo"
         }
       }
     }
   }
   

   • /path/to/kanban-mcp を、kanban-mcp ディレクトリの実際の絶対パスに置き換えます。

または、プロジェクトのルートに .cursor/mcp.json ファイルを作成し、同じ設定を記述することで、プロジェクト固有の設定を使用できます。

Docker ベースのデプロイやその他の高度なオプションについては、インストールガイドを参照してください。

📚 ドキュメント

ユーザー向け

• 🛠️ インストールガイド：Kanban MCP のインストールと設定方法
• 📝 使用ガイド：Claude で Kanban MCP を使用する方法
• 💡 機能と戦略：MCP サーバーの機能と LLM とのやり取りの戦略を詳しく解説します
• ⚠️ トラブルシューティング：よくある問題の解決方法

開発者向け

• 👨‍💻 開発者ガイド：Kanban MCP への貢献や変更を希望する開発者向けの情報
• 📖 API リファレンス：MCP コマンドと Planka API 連携の詳細なドキュメント

✨ 機能

Kanban MCP は、カンバンボードを管理するための包括的な機能を提供します。

📂 プロジェクト管理

• プロジェクトの作成と表示
• プロジェクトの設定とメンバーの管理

📊 ボード管理

• プロジェクト内でのボードの作成と表示
• ボード設定のカスタマイズ

📋 リスト管理

• ボード内でのリストの作成と整理
• 必要に応じたリストの並べ替え

🗂️ カード管理

• カードの作成、更新、削除
• リスト間でのカードの移動
• 説明、期限、ラベルの追加
• テンプレートとしてカードを複製

⏱️ 時間の追跡

• ストップウォッチの開始、停止、リセット
• 個々のタスクに費やした時間の記録
• 時間の使用パターンの分析

✅ タスク管理

• カード内でのタスクの作成と管理
• タスクの完了・未完了の設定

💬 コメント管理

• 議論のためのカードへのコメントの追加
• コメント履歴の表示

🤖 LLM との対話戦略

MCP Kanban は、LLM と人間が協力するための複数のワークフロー戦略をサポートしています。

1. 🤝 LLM 主導の開発と人間によるレビュー：LLM がタスクを実装し、人間がレビューしてフィードバックを提供します
2. 👥 LLM の支援による人間主導の開発：人間が実装し、LLM が分析や推奨事項を提供します
3. 🧠 共同でのタスク整理と計画：人間と LLM が協力してタスクを計画、整理します

これらの戦略の詳細については、Wiki ページ「機能と戦略」をご覧ください。

📦 利用可能な npm スクリプト

• npm run build：TypeScript コードをビルドします
• npm run build-docker：TypeScript コードをビルドし、Docker イメージを作成します
• npm run up：Planka コンテナ（kanban と postgres）を起動します
• npm run down：すべてのコンテナを停止します
• npm run restart：Planka コンテナを再起動します
• npm run start-node：Node で MCP サーバーを直接起動します（Cursor の外部でのテスト用）
• npm run qc：品質管理チェック（lint と型チェック）を実行します

🤝 コントリビューション

Kanban MCP へのコントリビューションを歓迎します。コントリビューションをご希望の場合は、以下をご確認ください。

1. プロジェクトの構成と開発ワークフローについては、開発者ガイドをご覧ください
2. 対応が必要なタスクについては、オープンなイシューをご確認ください
3. 変更を加えてプルリクエストを送信してください

🆘 サポート

Kanban MCP についてサポートが必要な場合は、以下をご確認ください。

1. よくある問題の解決策については、トラブルシューティングページをご覧ください
2. 問題が報告済みかどうかを確認するには、GitHub のイシューを検索してください
3. 解決策が見つからない場合は、新しいイシューを作成してください

📜 ライセンス

Kanban MCP は MIT License の下でライセンスされているオープンソースソフトウェアです。詳細については、LICENSEファイルをご覧ください。