PLANKA MCP服务器
一种模型上下文协议（MCP）服务器 计划 看板，专为克劳德和其他人工智能代理构建。
特性
- PLANKA 2.0 API全面支持
- 具有Zod验证的类型安全
- 针对代理工作流程进行了优化（组合操作、合理的默认值）
- 13个工具，涵盖卡片、任务、标签、评论和列表
安装
npm install @gogogadgetbytes/planka-mcp
或者直接运行：
npx @gogogadgetbytes/planka-mcp
配置
环境变量
| 变量 | 必填 | 描述 |
|---|
PLANKA_BASE_URL | 是 | 您的PLANKA服务器URL |
PLANKA_AGENT_EMAIL | 是 | 代理用户电子邮件 |
PLANKA_AGENT_PASSWORD | 是 | 代理用户密码 |
克劳德桌面版
添加 ~/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"
}
}
}
}
可用工具
导航
| 工具 | 说明 |
|---|
planka_get_structure | 获取项目、董事会和列表层次结构 |
planka_get_board | 制作一个包含所有卡片、列表和标签的板 |
卡
| 工具 | 说明 |
|---|
planka_create_card | 创建卡片（可选任务） |
planka_update_card | 更新卡属性 |
planka_move_card | 将卡片移动到不同的列表/位置 |
planka_get_card | 通过任务/评论获取卡片详细信息 |
planka_delete_card | 删除卡片 |
任务
| 工具 | 说明 |
|---|
planka_create_tasks | 将任务（清单项目）添加到卡片中 |
planka_update_task | 更新任务名称或完成情况 |
planka_delete_task | 删除任务 |
标签
| 工具 | 说明 |
|---|
planka_manage_labels | 创建/更新/删除电路板标签 |
planka_set_card_labels | 添加/删除卡片标签 |
评论
| 工具 | 说明 |
|---|
planka_add_comment | 在卡片上添加评论 |
planka_get_comments | 在卡片上获取所有评论 |
列表
| 工具 | 说明 |
|---|
planka_manage_lists | 创建/更新/删除列表 |
使用示例
获取板结构
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
许可证
麻省理工学院
链接
