MCP Kanban Memory

Name: MCP Kanban Memory
Author: eyalzh

本地服务

github.com/eyalzh记忆与知识4167 周前更新

代码仓库

关于 MCP Kanban Memory

MCP Kanban Memory 是一个 MCP 服务，为 AI Agent 提供基于看板的任务管理状态，适用于跨多个会话的复杂工作流。它基于 SQLite 存储，并提供 Web 界面用于观察进度和手动修改任务。

主要功能

01看板任务状态管理
02列容量与 WIP 限制
03SQLite 嵌入式数据库
04Web 界面查看与编辑任务
05启动与恢复工作流的预设提示词

适用场景

01规划阶段将计划记录为看板
02跨会话恢复并继续已有看板的工作
03在浏览器中跟踪 Agent 的任务进度

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露看板、任务和提示词相关的工具与提示词，例如 create-kanban-board、move-task 和 make-progress-on-a-project。

#mcp #project-management #kanban #memory-bank #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "kanban-mcp-eyalzh": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/mcp-kanban"
      ]
    }
  }
}

启动命令docker run -i --rm mcp/mcp-kanban

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocimcp/mcp-kanbanstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MCP 看板任务管理

一组 MCP 工具，为 AI 驱动的开发提供基于看板的任务管理状态。它与其他任务管理 MCP 工具类似，但额外提供了基于看板的任务管理系统的结构、规则和可视性。

核心思路是引导 AI Agent 在规划会话和执行会话中，都将工作记录并保存为看板上的任务。

亮点

列容量／进行中任务数量限制
内嵌数据库（SQLite）
Web 界面，可查看工作流进度并手动修改任务
用于启动和恢复工作流的预定义提示词

用法

使用 MCP 提示词启动项目或推进项目。
或者，请大模型助手通过创建看板来记录计划。在后续会话中推进项目时，请助手找到指定的看板并恢复工作。

安装

克隆此仓库，然后运行：

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
- 将任务从一列移动到另一列，并遵守进行中任务数量限制。
- 输入：
  - 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（字符串）：项目描述