Planka MCP

🚀 PLANKA MCP サーバー

PLANKA カンバンボード用のモデルコンテキストプロトコル (MCP) サーバーです。Claude やその他の AI エージェント向けに特別に構築されています。

✨ 主な機能

• PLANKA 2.0 API を完全にサポート
• Zod バリデーションによる型安全
• エージェントのワークフローに最適化（複合操作、合理的なデフォルト設定）
• カード、タスク、ラベル、コメント、リストをカバーする 13 のツール

📦 インストール

npm install @gogogadgetbytes/planka-mcp

または、直接実行する場合は：

npx @gogogadgetbytes/planka-mcp

🛠️ 設定

環境変数

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "planka": {
      "command": "npx",
      "args": ["@gogogadgetbytes/planka-mcp"],
      "env": {
        "PLANKA_BASE_URL": "https://planka.example.com",
        "PLANKA_AGENT_EMAIL": "agent@example.com",
        "PLANKA_AGENT_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code

~/.claude.json に以下を追加します：

{
  "mcpServers": {
    "planka": {
      "command": "npx",
      "args": ["@gogogadgetbytes/planka-mcp"],
      "env": {
        "PLANKA_BASE_URL": "https://planka.example.com",
        "PLANKA_AGENT_EMAIL": "agent@example.com",
        "PLANKA_AGENT_PASSWORD": "your-password"
      }
    }
  }
}

💻 利用可能なツール

ナビゲーション

カード

タスク

ラベル

コメント

リスト

💻 使用例

ボード構造の取得

planka_get_structure を使用して、すべてのプロジェクトとボードを表示します。

タスク付きのカードを作成

planka_create_card を以下のように使用します：
- listId: "abc123"
- name: "Implement feature X"
- tasks: ["Research", "Design", "Implement", "Test"]

ワークフローを通じてカードを移動

planka_move_card を使用して、カードを「To Do」から「In Progress」に移動します。

📚 PLANKA 2.0 互換性

このサーバーは PLANKA 2.0 用に設計されており、1.x との API の違いを処理します：

• カードの作成には必須の type フィールドが含まれます。
• ラベルのエンドポイントは /card-labels パスを使用します。
• オプションのフィールドは適切に処理されます。

🛠️ 開発

# クローン
git clone https://github.com/gogogadgetbytes/planka-mcp.git
cd planka-mcp

# インストール
npm install

# ビルド
npm run build

# テスト
npm test

📄 ライセンス

MIT

🔗 リンク

• PLANKA - カンバンボード
• MCP SDK - モデルコンテキストプロトコル
• 設計文書 - 技術的な設計詳細