Kan

Kan 是一款现代化的开源项目管理工具，为寻求数据主权和隐私控制的用户提供 Trello 的完美替代方案。它保留了看板式管理的直观与高效，同时通过自托管部署、精细的权限控制和即将推出的集成功能，满足了企业与个人开发者对灵活性和安全性的双重需求。

核心功能亮点

• 经典看板管理：
  • 支持卡片拖拽、标签分类、筛选搜索及详细的活动日志追踪。
  • 提供可复用的自定义模板，快速启动新项目。
  • 内置评论系统，促进团队在卡片层面的即时协作。
• 隐私与权限控制：
  • 看板可见性：精细控制谁可以查看或编辑特定看板。
  • 工作区成员：邀请团队成员协作，管理成员权限。
  • 自托管架构：数据完全掌握在自己手中，支持 Docker Compose 一键部署。
• 无缝迁移与集成：
  • Trello 导入：轻松将现有的 Trello 看板和数据迁移至 Kan。
  • MCP 服务器支持：内置模型上下文协议（MCP）服务器，允许 Claude Desktop、Cursor、GitHub Copilot 等 AI 客户端通过自然语言直接读取和控制 Kan 实例，实现 AI 驱动的项目管理。
• 现代化技术栈：
  • 基于 Next.js 构建，界面响应迅速。
  • 使用 PostgreSQL 存储数据，Redis 处理速率限制，S3 兼容存储管理附件。

快速部署指南

Kan 提供了极简的自托管方案，推荐使用 Docker Compose。

1. 准备环境变量

创建 .env 文件，配置必要的数据库连接和认证密钥：

POSTGRES_URL=postgres://kan:password@postgres:5432/kan_db
BETTER_AUTH_SECRET=<随机生成的32位以上字符串>
NEXT_PUBLIC_BASE_URL=http://localhost:3000
# 其他可选配置见上文表格

2. 启动服务

使用提供的 docker-compose.yml 配置，一键启动 Web 服务、数据库及迁移脚本：

docker compose up -d

• migrate 服务会自动执行数据库迁移。
• web 服务将在端口 3000（可配置）上运行。
• postgres 服务负责数据存储，并包含健康检查。

3. 访问应用

打开浏览器访问 http://localhost:3000 即可开始使用。

AI 集成：MCP 服务器

Kan 是少数原生支持 Model Context Protocol (MCP) 的项目管理工具之一。这意味着你可以让 AI 助手成为你的项目管理员：

• 自然语言操作：对 AI 说“把‘修复登录 Bug’这张卡片移到‘进行中’列”，AI 会自动调用 API 完成操作。
• 智能查询：询问“上周完成了哪些任务？”，AI 会从 Kan 中提取数据并生成报告。
• 安装方式：

  npx -y @kan/mcp
  

  只需配置 KAN_BASE_URL 和 KAN_API_TOKEN，即可将 Kan 接入任何兼容 MCP 的 AI 客户端。

本地开发

对于希望贡献代码或深度定制的开发者：

1. 克隆仓库：git clone https://github.com/kanbn/kan.git
2. 安装依赖：pnpm install
3. 配置环境：复制 .env.example 到 .env 并填写必要信息。
4. 迁移数据库：pnpm db:migrate
5. 启动开发服务器：pnpm dev