Planka MCP

PLANKA MCP服务器

一种模型上下文协议（MCP）服务器 计划 看板，专为克劳德和其他人工智能代理构建。

特性

• PLANKA 2.0 API全面支持
• 具有Zod验证的类型安全
• 针对代理工作流程进行了优化（组合操作、合理的默认值）
• 13个工具，涵盖卡片、任务、标签、评论和列表

安装

npm install @gogogadgetbytes/planka-mcp

或者直接运行：

npx @gogogadgetbytes/planka-mcp

配置

环境变量

克劳德桌面版

添加 ~/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.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"
      }
    }
  }
}

可用工具

导航

卡

任务

标签

评论

列表

使用示例

获取板结构

Use planka_get_structure to see all projects and boards

创建包含任务的卡片

Use planka_create_card with:
- listId: "abc123"
- name: "Implement feature X"
- tasks: ["Research", "Design", "Implement", "Test"]

通过工作流移动卡片

Use planka_move_card to move card from "To Do" to "In Progress"

PLANKA 2.0兼容性

此服务器专为PLANKA 2.0设计，可处理与1.x的API差异：

• 卡创建包括必需的 type 领域
• 标签端点使用 /card-labels 路径
• 可选字段处理得当

发展

# Clone
git clone https://github.com/gogogadgetbytes/planka-mcp.git
cd planka-mcp

# Install
npm install

# Build
npm run build

# Test
npm test

许可证

麻省理工学院

链接

• 计划 -看板
• MCP-SDK -模型上下文协议
• 设计文档 -技术设计细节