这是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型 (LLM) 驱动的工作流程提供结构化的任务管理能力。它通过看板（Kanban）形式组织任务，并允许 LLM 客户端通过 MCP 协议与看板进行交互，实现任务的规划、执行和追踪。

主要功能点

看板管理: 创建、获取和列出看板，每个看板代表一个项目或工作流。
任务管理: 在看板的指定列中创建、移动和删除任务，支持任务标题和详细内容（Markdown 格式）。
WIP 限制: 支持对看板列设置工作中的任务数量限制 (Work-in-Progress Limit)，帮助控制流程。
持久化存储: 使用 SQLite 数据库存储看板、列和任务数据，确保状态在会话之间保持一致。
工具接口: 提供了标准化的 MCP 工具接口，供 LLM 调用以执行看板操作，例如 'create-kanban-board', 'add-task-to-board', 'move-task', 'get-board-info' 等。
Prompt 模板: 提供了预定义的 MCP Prompt 模板，指导 LLM 如何启动基于看板的项目或在现有项目上取得进展。
Web UI (可选): 包含一个独立的 Web 服务器和用户界面，允许用户通过浏览器直观地查看和监控看板的当前状态（注意：Web UI 是单独运行的，不属于 MCP 服务器功能本身）。

安装步骤

分别安装数据库模块和 MCP 服务器模块的依赖并构建：

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

本 MCP 服务器通过标准的 Stdio 协议与 MCP 客户端通信。您需要将服务器的启动信息添加到您的 MCP 客户端（如 Claude Desktop）的配置中。配置通常是一个 JSON 对象，指定服务器的名称、启动命令和参数等。

以下是配置时需要包含的关键信息：

服务器名称 (Server Name): 为您的看板 MCP 服务器指定一个唯一的名称，例如 'kanban-mcp'。
启动命令 (Command): 启动服务器的程序，通常是 'node'。
参数 (Args): 传递给启动命令的参数，指向编译后的服务器主文件。例如：'/path/to/your/repo/mcp-server/dist/server.js' （请将 '/path/to/your/repo' 替换为您实际的仓库路径）。
环境变量 (Env): 您可能需要指定数据库文件存放的目录。例如，设置环境变量 'MCP_KANBAN_DB_FOLDER_PATH' 并将其值设置为您希望存储 SQLite 数据库文件的目录路径（请将 '/path/to/db' 替换为您希望存放数据库文件的目录）。

请参考您的 MCP 客户端文档来了解如何编辑其 MCP 服务器配置，并填入上述信息。

一旦 MCP 服务器配置并连接到您的 LLM 客户端，LLM 就可以发现并使用该服务器提供的能力。

由 LLM 发起: LLM 可以根据用户需求，通过调用内置的 MCP 工具（如 'create-kanban-board', 'list-boards'）来创建和管理看板及任务。
由用户引导: 您也可以通过触发服务器预定义的 Prompt 模板（如 'create-kanban-based-project', 'make-progress-on-a-project'）来启动一个由看板驱动的项目规划或执行流程，引导 LLM 使用看板来组织工作。

LLM 会通过 MCP 协议调用服务器的工具来创建看板、添加任务、移动任务等，并获取看板信息以了解项目进展。服务器负责在后台管理数据库中的看板状态，并将操作结果或看板信息返回给 LLM。

如果您想通过浏览器查看看板内容，可以额外安装并运行 Web UI：

安装 Web UI 和 Web 服务器依赖并构建：

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

启动 Web 服务器，需要指定数据库文件路径：

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

（请将 '/path/to/db' 替换为您在 MCP 服务器配置中使用的数据库路径）。