Kanban MCP

🚀 看板 MCP 项目

这个项目将 Planka（一个开源看板）与 Cursor 的机器控制协议 (MCP) 集成，让 AI 助手（如 Claude）能够管理您的看板，为看板管理带来全新的人机协作体验。

🚀 快速开始

Kanban MCP 是 Planka 和 Cursor 的 MCP 之间的桥梁，它让 AI 助手可以参与到看板管理的各项工作中。以下是快速上手该项目的步骤：

先决条件

1. 安装 Node.js 和 npm
2. 安装 Docker（用于运行容器化环境）

安装步骤

# 克隆仓库
git clone https://github.com/bradrisse/kanban-mcp.git
cd kanban-mcp

# 安装依赖项
npm install

# 启动服务
npm run start-node

✨ 主要特性

• 任务管理：创建、更新和跟踪任务状态。
• 评论系统：在看板上添加讨论内容。
• 看板集成：与 Planka 看板无缝集成。
• 多策略协作：支持多种人机协作模式。

📦 安装指南

先决条件

• 安装 Node.js 和 npm
• 安装 Docker（用于运行容器化环境）

安装步骤

# 克隆仓库
git clone https://github.com/bradrisse/kanban-mcp.git
cd kanban-mcp

# 安装依赖项
npm install

# 启动服务
npm run start-node

💻 使用示例

基础用法

您可以按照以下步骤使用 Kanban MCP 进行基本的看板管理：

1. 完成上述安装步骤。
2. 启动服务后，登录到 Planka 看板。
3. 借助 AI 助手（如 Claude）开始创建、管理任务，添加评论等操作。

📚 详细文档

用户指南

• 快速开始：了解如何快速上手使用 Kanban MCP。
• 安装：详细安装步骤和配置说明。
• 功能：探索所有可用功能及其用法。

开发者指南

• 代码结构：了解项目的整体架构。
• 开发流程：参与贡献的开发流程说明。
• 测试策略：项目采用的质量控制措施。

🔧 技术细节

机器学习模型交互策略

Kanban MCP 支持以下工作流策略：

1. LLM 驱动开发 + 人工审核：AI 执行任务，人类进行最终检查和反馈。
2. 人工驱动开发 + AI 辅助：人类执行任务，AI 提供分析和支持。
3. 协作式梳理与规划：人机共同参与任务的规划和组织。

更多详细信息，请参阅 _capabilities and strategies Wiki 页面。

可用 npm 脚本

• npm run build：构建 TypeScript 代码
• npm run build-docker：构建 Docker 镜像
• npm run up：启动 Planka 容器（kanban 和 postgres）
• npm run down：停止所有容器
• npm run restart：重启 Planka 容器
• npm run start-node：直接使用 Node 启动 MCP 服务（用于测试环境）
• npm run qc：运行质量控制检查（包括代码审查和类型检查）

🤝 贡献指南

欢迎贡献！了解如何参与项目：

1. 查看 Developer Guide 以获取详细信息。
2. 检查 open issues 中的任务，寻找适合您的工作。

🆘 支持

需要帮助？请参考：

1. 故障排除 页面解决常见问题。
2. 在 GitHub 问题 中查找已报告的问题。
3. 如果找不到解决方案，请打开新问题。

📄 许可证

Kanban MCP 是开源软件，使用 MIT 许可证。查看 LICENSE 了解详细信息。