Kanban MCP

🚀 MCP 看板

MCP 看板是一种 MCP 工具集，专为复杂多会话工作流中的 AI 代理设计，可提供内部任务管理状态。它与其他记忆 MCP 工具类似，但增添了看板式任务管理系统的结构、规则和可见性，能指导 AI 代理在看板中记录和保存工作，无论是会议计划还是执行阶段都适用。

✨ 主要特性

• 列容量 / 工作进度限制
• 嵌入式数据库 (SQLite)
• 具备观察工作进展和手动修改任务功能的 Web UI
• 用于开始和恢复工作流的预定义提示

🚀 快速开始

使用 MCP 提示词即可启动一个项目或推动项目进展。也能让大语言模型助手通过创建看板来记录其计划。若要在后续会议中继续工作，指示助手定位特定的看板并恢复工作即可。

📦 安装指南

常规安装

1. 克隆此仓库，然后执行以下命令：

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

2. 将 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 替换为您希望包含 DB 文件的文件夹，该文件夹需具备读写权限，若不存在则会自动创建。

使用 Docker 安装

1. 构建 Docker 镜像：

docker build -t mcp/mcp-kanban .

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

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

请将 /path/to/db 替换为您希望包含 DB 文件的文件夹，该文件夹需具备读写权限。

使用 Web UI

1. 构建 Web 界面和 Web 服务器：

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

2. 运行 Web 服务器：

node server.js

3. 在浏览器中访问 http://localhost:3000。

💻 使用示例

基础用法

以下是使用 API 工具的基础示例：

创建看板

# 使用 POST /kanban 创建新的看板
curl -X POST http://localhost:3000/kanban

获取所有看板

# 使用 GET /kanban 获取所有看板列表
curl -X GET http://localhost:3000/kanban

更新任务状态

# 使用 PUT /kanban/{boardId}/task/{taskId} 更新特定任务的状态
curl -X PUT http://localhost:3000/kanban/123/task/456

高级用法

基于看板创建项目

通过创建一个看板，提出问题将项目分解为任务，并将其添加到看板中。例如，使用大语言模型助手创建看板并添加任务：

# 假设使用某种方式调用大语言模型助手创建看板并添加任务
# 这里只是示意，具体实现根据实际情况而定

在现有项目上取得进展

定位其看板，选择下一个任务并进行处理。例如，通过 API 定位看板并获取下一个任务：

# 假设通过 API 获取看板信息并选择下一个任务
# 这里只是示意，具体实现根据实际情况而定

📚 详细文档

API 工具

工具

• 创建看板：使用 POST /kanban 创建新的看板。
• 获取所有看板：使用 GET /kanban 获取所有看板列表。
• 更新任务状态：使用 PUT /kanban/{boardId}/task/{taskId} 更新特定任务的状态。

提示

• 基于看板创建项目：通过创建一个看板，提出问题将项目分解为任务，并将其添加到看板中。
• 在现有项目上取得进展：定位其看板，选择下一个任务并进行处理。