Kaneo:自带 MCP 服务的自托管项目管理平台

Kaneo(usekaneo/kaneo)是一个开源自托管项目管理平台,GitHub 8.5k star、711 fork,最新版 v2.22.0 于 2026-08-21 发布,TypeScript 占 93.4%,MIT 协议。它的定位是 Jira 和 Linear 的轻量替代:看板、待办、列表、标签、子任务、评论、附件一应俱全,但没有庞大的插件市场与配置负担。与同类自托管项目最大的区别是每个实例都内置一个官方 MCP 服务器——Claude、Cursor 等 AI 工具可以在你授权后直接读任务、建任务、改状态,这是它把「项目管理」与「AI 协作」接到一起的核心能力。

项目起源:功能过剩的痛点

Kaneo 的 README 把问题说得很直白:大多数项目管理工具不是功能不够,而是功能过剩。每一个多余的通知、按钮和流程都在把团队从「把产品做出来」这件事上拉开。团队自然的工作方式应该是工具去适应人,而不是人去适应工具。所以 Kaneo 的每一项功能只为一个真实问题存在,原则是「All you need. Nothing you don't.」(你需要的都有,不需要的都没有)。

对应到落地形态:Kaneo 一个 Docker Compose 文件即可运行,数据存在自己的 PostgreSQL 里,MIT 协议没有许可成本。

覆盖日常的项目管理功能

Kaneo 以工作区(Workspace)为顶层容器,内部创建项目,每个项目同时提供看板与列表两种视图,共享同一份数据——在列表里排期、在看板上执行,状态、优先级、标签始终同步。

  • 任务管理:创建任务、指派负责人、设优先级、贴标签、定截止日期;子任务、文件附件、评论、活动历史、任务间关联都有。
  • 标签体系:标签是跨项目的主组织维度,一个工作区统一命名,按「后端」「用户反馈」这类流线筛选时不至于失控。
  • 集成与通知:原生 GitHub、Gitea 集成,把 issue 与代码侧同步起来;Webhook 可把事件推给 Slack、Discord、Telegram 或任意 HTTP 端点。
  • 自动化:调度器跑截止日期提醒,避免任务悄悄过期;REST API 供脚本与 CI 调用。

内置 MCP 服务器:AI 直接进任务板

Kaneo 对 MCP(Model Context Protocol)的支持是官方一等公民,而不是事后接线。每个实例都自带一个 HTTP MCP 端点 /api/mcp,AI 客户端(Claude、Cursor 及其他 MCP 客户端)把该地址加进去,跳转到 Kaneo 登录页完成授权后,就能用工具调用管理你的任务、项目与标签——例如让 Claude 把今天的会议记录拆成任务、按负责人分派并设好截止日期。对 stdio 客户端(本地进程式连接),官方 npm 包 @kaneo/mcp(npx -y @kaneo/mcp)同样可用。

这意味着自托管项目管理不再只是「人和人协作」:AI 协作者和团队成员看到的是同一个任务板,无需贴截图、无需口头同步。

部署方式:从单容器到 Kubernetes

  • drim 两条命令安装:官方 CLI(curl -fsSL https://assets.kaneo.app/install.sh | sh,然后 drim setup),自动生成配置、装 Docker、配 Caddy 自动 HTTPS,适合直接上生产。
  • Docker Compose:应用本体单容器,依赖 PostgreSQL 16:ghcr.io/usekaneo/kaneo:latest 配一个 Postgres 实例,设好 KANEO_CLIENT_URL、POSTGRES_PASSWORD、AUTH_SECRET 后 docker compose up -d,打开 http://localhost:5173 即可。AUTH_SECRET 用 openssl rand -hex 32 生成,留空会导致每次启动重新生成、会话全部失效。
  • Coolify / Railway:官方提供 Coolify 专用 compose.coolify.yml 与一键模板,不想养服务器的可以直接用托管模板。
  • Kubernetes:仓库 charts/kaneo 下附带 Helm chart,含 ingress、HPA、PVC 模板,TLS 有示例配置。

技术栈与项目状态

Kaneo 是 pnpm + Turborepo 的 monorepo:前端 React + Tailwind,后端 Hono API,接口规范由 Zod 定义后自动生成 OpenAPI(仓库最近一次提交 2026-08-24 仍在推进这一改造),数据库 PostgreSQL。仓库累计 2746 次提交、148 个 release、100 名贡献者。

在 Jira 和 Linear 按席位收费、数据留存在供应商云端的背景下,自托管项目管理又回到了可选位置。Kaneo 提供了一条低门槛路径:日常看板式管理与原生 MCP 一并打包进一个 MIT 协议的单容器应用,花十分钟即可跑起来。一句话带走:2026 年自托管项目管理,Kaneo 是「功能够用 + 原生 MCP」这个组合上最稳妥的选择之一。