Planka MCP

🚀 PLANKA MCP 服務器

這是一個專為 PLANKA 看板打造的模型上下文協議（MCP）服務器，專為 Claude 及其他 AI 智能體設計。

🚀 快速開始

PLANKA MCP 服務器是一個為 PLANKA 看板服務的 MCP 服務器，可與 Claude 等 AI 智能體協同工作。你可以按照以下步驟進行安裝和配置。

✨ 主要特性

• 全面支持 PLANKA 2.0 API。
• 通過 Zod 驗證實現類型安全。
• 針對智能體工作流程進行優化（支持組合操作，提供合理默認值）。
• 擁有涵蓋卡片、任務、標籤、評論和列表的 13 種工具。

📦 安裝指南

你可以使用以下命令安裝 PLANKA MCP 服務器：

npm install @gogogadgetbytes/planka-mcp

或者直接運行：

npx @gogogadgetbytes/planka-mcp

📚 詳細文檔

配置

環境變量

Claude 桌面版

在 ~/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 代碼版

在 ~/.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 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

💻 使用示例

獲取看板結構

使用 planka_get_structure 查看所有項目和看板

創建帶任務的卡片

使用 planka_create_card 並提供以下參數：
- listId: "abc123"
- name: "實現功能 X"
- tasks: ["研究", "設計", "實現", "測試"]

在工作流中移動卡片

使用 planka_move_card 將卡片從“待辦”移動到“進行中”

📄 許可證

本項目採用 MIT 許可證。

🔗 鏈接

• PLANKA - 看板工具
• MCP SDK - 模型上下文協議
• 設計文檔 - 技術設計細節