AI导哈

看板模型协议服务器

为Planka看板提供模型上下文协议(MCP)服务的Rust服务器，支持项目、面板、卡片管理等核心操作。

  • by AcceleratedIndustries
  • Rust
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 AcceleratedIndustries/planka-mcp

使用说明

木板mcp

一种模型上下文协议（MCP）服务器 普兰卡 用Rust写的看板。

安装

来自GitHub（推荐）

cargo install --git https://github.com/AcceleratedIndustries/planka-mcp

来源

git clone https://github.com/AcceleratedIndustries/planka-mcp
cd planka-mcp
cargo build --release

设置

环境变量

export PLANKA_URL="https://kanban.local"

# Option 1: Bearer token (preferred)
export PLANKA_TOKEN="your-token-here"

# Option 2: Email/password authentication
export PLANKA_EMAIL="admin@example.com"
export PLANKA_PASSWORD="your-password"

跑

# If installed via cargo install:
planka-mcp

# If built from source:
./target/release/planka-mcp

MCP客户端配置

添加到MCP客户端配置中：

{
  "mcpServers": {
    "planka": {
      "command": "/path/to/planka-mcp",
      "env": {
        "PLANKA_URL": "https://kanban.local",
        "PLANKA_TOKEN": "your-token"
      }
    }
  }
}

可用工具

工具 描述 程序化
list_projects 列出所有Planka项目 是
list_boards 列出项目中的板 是
list_lists 列出板上的列 是
list_cards 在板上列出卡片 是
create_board 创建新董事会（需要项目经理角色） 是
create_list 在板上创建新列 是
create_card 在列表中创建新卡 是
update_card 更新卡名称/描述 是
move_card 将卡片移动到其他列表 是
delete_card 删除卡片 否
delete_list 删除列表及其所有卡片 否

程序化工具调用（测试版）

此服务器支持 Anthropic的程序化工具调用 测试版功能，允许Claude编写Python代码，有效地编排多个工具调用。

大多数工具都可以通过以下方式进行编程调用 allowed_callers: ["code_execution_20250825"]。出于安全考虑，删除操作被排除在外。

在人类API中启用

import anthropic

client = anthropic.Anthropic()
response = client.beta.messages.create(
    betas=["advanced-tool-use-2025-11-20"],
    model="claude-sonnet-4-5-20250929",
    max_tokens=4096,
    tools=[
        {"type": "code_execution_20250825", "name": "code_execution"},
        # Include your planka-mcp tools here with their schemas
    ]
)

示例用例

启用程序化调用后，Claude可以有效地处理批处理操作：

  • “将所有包含“已阻止”的卡移动到“阻止”列”
  • “为此列表中的每个项目创建卡片”
  • “找到所有分配给我的卡片”

Claude代码集成

添加到 ~/.claude/mcp.json:

{
  "mcpServers": {
    "planka": {
      "command": "/path/to/planka-mcp",
      "env": {
        "PLANKA_URL": "https://kanban.local",
        "PLANKA_EMAIL": "user@example.com",
        "PLANKA_PASSWORD": "your-password"
      }
    }
  }
}

然后重新启动Claude Code或运行 /mcp 查看服务器。

延伸

要添加新工具，请执行以下操作：

  1. 将HTTP方法添加到 src/planka/client.rs
  2. 将任何新类型添加到 src/planka/types.rs
  3. 将工具定义和处理程序添加到 src/tools/mod.rs

未来需要考虑的工具：

  • add_comment -在卡片上添加评论
  • set_due_date -设置卡片到期日
  • add_label -为卡片添加标签

许可证

麻省理工学院

相关 MCP