MCP 看板任务管理

一个提供基于看板的任务管理状态的MCP工具集，适用于AI驱动的开发。这类似于其他任务管理MCP工具，但增加了基于看板的任务管理系统特有的结构、规则和可见性。

主要思想是引导AI代理将其工作记录并保存为看板上的任务，在规划阶段和执行阶段都如此。

特点

• 列容量/在制品限制
• 嵌入式数据库（SQLite）
• Web界面用于观察工作流程的进度，并手动修改任务
• 预定义提示以启动和恢复工作流

使用方法

使用MCP提示来启动项目或推进项目。 或者，让LLM助手通过创建看板来记录其计划。要在后续会话中继续进行，请让助手定位特定的看板并继续在其上工作。

安装

克隆此仓库，然后运行：

npm ci --prefix shared/db
npm ci --prefix mcp-server
npm run build --prefix shared/db
npm run build --prefix mcp-server

然后将MCP服务器配置添加到MCP客户端（例如Claude Desktop）：

"mcpServers": {
    "kanban-mcp": {
        "command": "node",
        "args": [
            "/path/to/repo/mcp-server/dist/server.js"
        ],
        "env": {
            "MCP_KANBAN_DB_FOLDER_PATH": "/path/to/db"
        }
    }
}

将/path/to/repo替换为克隆的仓库位置。

将/path/to/db替换为将包含数据库文件的文件夹。这可以是具有读写权限的任何文件夹。如果不存在，将会被创建。

使用Docker安装

构建Docker镜像：

docker build -t mcp/mcp-kanban .

然后将MCP服务器配置添加到MCP客户端（例如Claude Desktop）：

"mcpServers": {
    "kanban-mcp": {
        "command": "docker",
        "args": [
            "run",
            "--rm",
            "-i",
            "-v",
            "/path/to/db:/mcp",
            "mcp/mcp-kanban"
        ]
    }
}

将/path/to/db替换为将包含数据库文件的文件夹。这可以是具有读写权限的任何文件夹。如果不存在，将会被创建。

使用Web界面

构建web-ui和web-server：

npm ci --prefix shared/db
npm run build --prefix shared/db

npm ci --prefix web-ui
npm ci --prefix web-server
npm run build --prefix web-ui
npm run build --prefix web-server

运行web-server：

MCP_KANBAN_DB_FOLDER_PATH=/path/to/db npm run start --prefix web-server

在浏览器中打开http://localhost:8221

API

工具

• create-kanban-board

  • 创建一个新的看板来规划和跟踪您的任务。
  • 输入：
    • name (字符串)：看板的名称
    • projectGoal (字符串)：项目的目标。

• add-task-to-board

  • 将新任务添加到看板的待办事项列。
  • 输入：
    • boardId (字符串)：要添加任务的看板ID
    • title (字符串)：任务的标题
    • content (字符串)：任务的内容，以Markdown格式

• move-task

  • 将任务从一列移动到另一列，遵守WIP限制。
  • 输入：
    • taskId (字符串)：要移动的任务ID
    • targetColumnId (字符串)：要移动任务的目标列ID
    • reason (字符串，可选)：移动任务的原因

• delete-task

  • 删除任务。
  • 输入：
    • taskId (字符串)：要删除的任务ID

• get-board-info

  • 获取看板的全部信息，包括列和任务。
  • 输入：
    • boardId (字符串)：要获取信息的看板ID
  • 返回关于看板的详细信息，包括列和任务。

• get-task-info

  • 获取任务的全部信息，包括其内容。
  • 输入：
    • taskId (字符串)：要获取信息的任务ID
  • 返回关于任务的详细信息，包括其内容。

• list-boards

  • 列出数据库中的所有看板。
  • 输入：无
  • 返回数据库中所有看板的列表，包括它们的名称、创建时间和目标。

提示

• create-kanban-based-project

  • 为项目创建一个看板，询问问题以将项目划分为任务，并将它们添加到看板中。
  • 输入：
    • description (字符串)：项目的描述

• make-progress-on-a-project

  • 通过定位其看板，选择下一个任务并开始工作来推进现有项目。
  • 输入：
    • description (字符串)：项目的描述