AB
AiBoss站
project

kanzo - 把看板与 MCP 服务器装进一个 4.5 MB 程序

kanzo 是一个把浏览器看板和 MCP 服务器合在同一个程序里的任务管理工具,项目自述体积 4.5 MB、无需账号与服务器,人和编码 agent 在同一块看板上协作。本文据官方接口与项目 README 介绍其维护状态、主要能力、安装与调用入口,以及 AGPL-3.0 许可下的已知限制。

kanzo 是一个把看板(kanban board)和 MCP 服务器合在同一个程序里的任务管理工具。按项目自述,它的目标是让人和编码 agent 处理同一批任务:看板在浏览器里给人用,MCP 给 agent 用,命令行给终端和脚本用,三者读写的是同一份数据。它面向的是希望把「待办—进行中—完成」这类任务流交给 agent 参与、又不想为此搭一套账号体系或后端服务的开发者。据项目说明,它不需要账号、不需要服务器、也不需要额外配置,运行 kanzo 即可使用,全程不需要手工编辑文件。

维护者与状态

仓库由 emanuele-em 维护,地址为 github.com/emanuele-em/kanzo。按官方接口数据,仓库创建于 2026-10-25,最后提交时间为 2026-11-02,最新正式版本为 v0.3.0(2026-11-01)。截至 2026-11-03,仓库星标数为 885。许可证为 AGPL-3.0。

从时间线看,这是一个相当新的项目:创建到最新提交不足两周,版本号仍在 0.x 阶段。使用前应把这一点纳入考量——接口、命令与数据格式都可能随版本变化。

主要能力

以下内容均据项目 README 自述,未经独立验证。

  • 浏览器看板:运行 kanzo 后看板在 http://localhost:4242 打开,首次运行会创建 ~/kanzo 目录,整个看板的数据都存放在其中。README 列出了若干键盘操作:n 新建任务,/ 或 ⌘K 跨项目搜索,f 过滤看板、↵ 保留过滤条件,Tab 跳到描述,⌘↵ 保存并关闭,Esc 取消。
  • 人机分工标记:可以把任务标记为 Human,agent 会跳过这些任务,只由人处理;界面上的人形图标只显示这类任务。
  • MCP 接入 agent:agent 通过 MCP 领取任务、移动卡片、写评论。README 称 agent 会依据所在仓库的 git remote 自动匹配到对应项目,也可以在项目的 ⋯ 菜单里把更多仓库关联到同一项目。
  • Backlog 列:在设置中开启 Backlog 后,会多出一列 agent 不会触碰的区域,直到人把其中的任务移到 todo。
  • 多机共享:同一网络下,一台机器开启共享、其他机器加入,即可同时看到同一块看板,各自的 agent 通过同一个 kanzo mcp 使用它。README 也描述了用树莓派常驻看板、以及通过 VPN 跨网络访问的用法。
  • Git 同步:面向轮流使用多台机器的场景,可以把 ~/kanzo 变成一个 git 仓库,推送到自己拥有的私有仓库,在其他机器上用同一地址拉取。README 称在看板和 agent 运行期间执行同步是安全的;若两端都改过看板,会询问保留哪一份。
  • 导出:kanzo export 可把看板打印为 Markdown,-f json 输出 JSON,-p 限定单个项目,-o 保存到文件。
  • 附件:可把图片粘贴或拖入任务与评论中作为附件。
  • 自更新:有新版本时侧边栏会提示,点击即可安装;kanzo update 也可安装最新版本并重启服务。

README 还给出了一组体积与性能自述数据:程序 4.5 MB(含 SQLite),空闲内存 4.5 MB、3000 个任务时 8 MB,启动 2 ms,3000 个任务的看板在浏览器中加载 17 ms,agent 的工具列表约 900 token(每会话一次),agent 回复为 10 至 60 token 的纯文本。这些数字由项目方在 Apple M4 上测得,属于自述口径。

使用入口

仓库地址:emanuele-em/kanzo。

据 README,macOS 与 Linux(含树莓派)可用安装脚本:

curl -LsSf https://github.com/emanuele-em/kanzo/releases/latest/download/kanzo-installer.sh | sh

Windows 在 PowerShell 中执行:

powershell -ExecutionPolicy Bypass -c "irm https://github.com/emanuele-em/kanzo/releases/latest/download/kanzo-installer.ps1 | iex"

也可以通过 Cargo 安装:

cargo install kanzo

启动看板:

kanzo

把 kanzo 注册为 MCP 服务器(README 给出的 Claude Code 与 Codex 示例):

claude mcp add kanzo --scope user -- kanzo mcp
codex mcp add kanzo -- kanzo mcp

其他 MCP 客户端可运行 kanzo mcp,或直接使用运行中看板的 http://localhost:4242/mcp。README 提到 Raycast 一类应用需要 which kanzo 得到的完整路径。

许可与限制

许可证为 AGPL-3.0。按 README 的说明,这意味着可以使用、修改和分发;如果通过网络提供修改后的版本,也需要公开其源代码。

使用边界方面,README 明确写出的几点值得注意:

  • 共享没有登录机制,项目建议只在可信网络上开启共享。
  • 数据落在本地目录:看板存于 ~/kanzo/kanzo.db,设置存于 config.toml;可用 --home 或 KANZO_HOME 指定其他目录。默认监听 127.0.0.1,共享时会向网络开放。
  • Windows 自更新有条件:README 称只有把 kanzo.exe 放在 PATH 上的 bin 目录(如 %USERPROFILE%\.cargo\bin)时,看板才会自行更新。
  • 版本较新:项目创建于 2026-10-25,最新版本为 v0.3.0,处于早期阶段。

上述能力、命令与性能数字均来自项目自述,本文未对项目进行实际运行验证;具体行为请以仓库当前版本的文档与代码为准。