Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Cherry Studio Task Board list tasks in the 'In Progress' column of the 'Release v2' project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bun + TypeScript + SQLite + MCP 协议的任务管理系统。为 Cherry Studio Agent 提供 Kanban / Gantt / 列表 / 多项目 / 归档等完整任务管理能力。
┌─────────────────────┐ MCP (stdio) ┌──────────────────┐
│ Cherry Studio │ ◄──────────────────► │ mcp-server.ts │
│ Agent (Claude) │ │ 16 tools: │
│ Mini App (HTML) │ │ create_task │
│ │ │ list_tasks │
└─────────┬───────────┘ │ update_task │
│ │ move_task │
│ HTTP :17850 │ delete_task │
▼ │ list_projects │
┌─────────────────────┐ │ create_project │
│ standalone- │ │ get_task_context│
│ kanban.html │ │ add_comment │
│ │ │ list_comments │
│ Kanban · Gantt │ │ link_dependency │
│ List · 标签筛选 │ │ list_dependencies│
│ 多项目 · 归档 │ │ unlink_dependency│
│ Activity Log │ │ archive_project │
│ │ │ unarchive_project│
└─────────────────────┘ │ backup_database │
└────────┬─────────┘
│
│ SQLite (WAL)
▼
┌──────────────────┐
│ tasks.db │
│ 6 表 · 外键 · │
│ 活动日志 · 评论 │
└──────────────────┘Related MCP server: Gorev Task Management Server
功能 | 说明 |
Kanban 看板 | Backlog → Todo → In Progress → Done 四列拖拽 |
Gantt 甘特图 | 时间线视图，支持日期范围缩放 |
列表视图 | 表格 + 高级筛选（状态/优先级/日期/标签） |
标签筛选 | 预设筛选器 + 自定义标签组合 |
多项目管理 | 创建/切换项目，每项目独立任务集 |
项目归档 | 软归档/恢复，归档后任务只读 |
活动日志 | 每项操作记录（创建/更新/移动/评论/依赖） |
任务依赖 | blocks / branches / merges / sync 四种依赖类型 |
自动备份 | SQLite 数据库一键备份 |
全文搜索 | 标题 + 描述 + 评论全文检索 |
本看板由两部分组成：MCP Server（供 Agent 调用）和 看板前端（Mini App）。MCP Server 启动后会同时提供 HTTP 服务（端口 17850），前端通过 HTTP API 读写数据。
git clone https://github.com/Trojan-Seahorse/cardo.git
cd cardo或者直接下载 ZIP 解压到本地目录。
Cherry Studio 在首次启用 MCP 时已自动安装 Bun 到 C:\Users\<用户名>\.cherrystudio\bin\bun.exe，直接用它安装依赖：
C:\Users\<用户名>\.cherrystudio\bin\bun.exe install如果还没启用过任何 MCP，先打开 Cherry Studio → 设置 → MCP 服务器，点击右上角的 安装 按钮即可自动下载 Bun。
打开 设置 → MCP 服务器 → 点右上角 编辑 JSON，粘贴以下内容（把两处 <用户名> 换成你的 Windows 用户名）：
{
"mcpServers": {
"cardo": {
"command": "C:\\Users\\<用户名>\\.cherrystudio\\bin\\bun.exe",
"args": [
"run",
"D:\\Cherry Studio\\task-board\\mcp-server.ts"
],
"env": {
"TASK_BOARD_DB": "D:\\Cherry Studio\\data\\tasks.db"
}
}
}
}点 确定 保存，Cherry Studio 会自动启动 MCP Server。点击服务器条目可查看运行状态。
路径说明：上面以
D:\Cherry Studio\为例。如果你把项目放到了其他位置，把args和TASK_BOARD_DB改成实际路径。TASK_BOARD_DB也可以不设，默认在项目上级的data\tasks.db。
对话模式：聊天框下方找到 MCP 工具图标 → 勾选 cardo
Agent 模式：Agent 编辑 → 工具 → MCP 分组下勾选 cardo
MCP Server 启动后自动开启 HTTP 服务（端口 17850）。把看板加到 Cherry Studio 的 Mini App：
Cherry Studio 顶部 + → 启动台 → 小程序
滑到底部点 自定义：
字段 | 值 |
名称 |
|
URL |
|
图标 | 留空即可 |
保存后在 Mini App 网格中打开看板
右键图标 → 添加到启动台，固定到顶部 Tab 方便随时切换
关于
data:URL：项目中data-url.txt包含 HTML 的 base64 编码，但不推荐——data:URL 的 webview 受同源策略限制，无法fetch到localhost:17850，看板会没有数据。
在 Cherry Studio 聊天框输入：
列出所有任务
Agent 调用了 list_tasks 则 MCP 连接正常。打开 Mini App 看板也能看到数据。
Cherry Studio 支持导入 MCPB（MCP Bundle，原名 DXT）文件，可实现免配置一键安装。
先用 Bun 编译为独立 .exe（含 Bun 运行时 + SQLite + 全部依赖）：
C:\Users\<用户名>\.cherrystudio\bin\bun.exe build --compile mcp-server.ts --outfile server/mcp-server.exe创建 manifest.json：
{
"manifest_version": "0.3",
"name": "cardo",
"version": "0.2.0",
"description": "Cardo · Kanban / Gantt / 多项目 / 归档",
"author": { "name": "Xi Ewell" },
"server": {
"type": "binary",
"mcp_config": {
"command": "${__dirname}/server/mcp-server.exe",
"args": [],
"env": {
"TASK_BOARD_DB": "${__dirname}/../data/tasks.db"
}
}
},
"license": "MIT",
"compatibility": { "platforms": ["win32"] }
}打包为 .mcpb（本质是 zip）：
# 确保目录结构为：
# task-board/
# manifest.json
# server/mcp-server.exe
Compress-Archive -Path manifest.json, server -DestinationPath cardo.mcpbCherry Studio → 设置 → MCP 服务器 → 添加服务器 → 选择 DXT/MCPB 导入 → 选中 .mcpb 文件。
⚠️ Cherry Studio 的 MCPB 导入目前有部分已知问题（路径变量替换、配置表单），导入后建议检查
命令和参数是否正确。如遇问题，回退到上方的 JSON 方式。
SQLite (WAL 模式)。数据库文件位于 ../data/tasks.db（相对于 task-board 目录）。
环境变量 TASK_BOARD_DB 可自定义路径。
首次启动自动创建表结构（schema.sql）并迁移 archived_at 列。
表 | 说明 |
| 项目（含 archived_at 软归档） |
| 任务卡片（标题/状态/优先级/进度/标签/日期/负责人） |
| 任务依赖关系 |
| 操作审计日志 |
| 任务评论/Markdown |
| 自动备份记录 |
工具 | 说明 |
| 创建任务（title 必填，支持 project_id / parent_id / tags / due_date） |
| 列表查询（status / priority / search / project_id / parent_id / dependency_status） |
| 更新字段（title / description / priority / progress / due_date / assigned_to / tags） |
| 移动状态列（backlog → todo → in-progress → done，done 自动 100%） |
| 删除任务及关联日志/评论（归档项目禁止） |
| 获取任务完整上下文（详情 + 评论 + 依赖 + 子任务 + 活动日志） |
工具 | 说明 |
| 给任务添加评论/Markdown |
| 查看任务评论列表 |
工具 | 说明 |
| 创建任务依赖（blocks / branches / merges / sync） |
| 查询依赖关系 |
| 删除依赖 |
工具 | 说明 |
| 列出项目（支持 include_archived） |
| 创建新项目 |
| 归档项目（任务变只读） |
| 恢复已归档项目 |
工具 | 说明 |
| 备份 SQLite 数据库 |
文件 | 用途 |
| MCP + HTTP 一体服务器（16 tools + REST API） |
| 单文件前端（Kanban / Gantt / List / 多项目 / 归档） |
| 数据库 DDL（6 表 + 索引） |
| 项目配置与依赖 |
| MCP 工具测试脚本 |
| update_task / move_task 测试 |
| 数据库完整性验证 |
| 看板 UI 原型 |
| 甘特图原型 |
Runtime: Bun — JavaScript/TypeScript 运行时
Database: SQLite (WAL 模式, bun:sqlite)
Protocol: MCP (Model Context Protocol) — stdio 传输
HTTP Server: Bun.serve (内置于 mcp-server.ts，端口 17850)
Frontend: Vanilla HTML/CSS/JS (standalone-kanban.html)
Schema Validation: Zod
MIT
Xi Ewell
This server cannot be deployed
Task & board management for AI agents + humans. Kanban, comments, digests via MCP.
Work management where AI agents are first-class members: tasks, projects, memory over hosted MCP
Kanban board for teams and coding agents: manage tasks, subtasks, sprints and wiki pages via MCP.
Project management MCP for AI agents with safe task reads and writes.
