创建MCP看板
🚀 使用MCP服务器为Claude Code设置完整的看板工作流系统
在您的项目中实施严格的看板工作流程,利用自动化工单管理、状态机强制执行以及针对Claude Code的全面工具支持。
快速入门
npx create-mcp-kanban或者全局安装:
npm install -g create-mcp-kanban
create-mcp-kanban它的功能/作用
这个工具在您的项目中建立了一个完整的看板工作流系统:
- ✅ MCP服务器 - 配备SQLite数据库的完整票务管理系统
- ✅ 专业代理 - 规划、实施和审查机构/人员
- ✅ 斜杠命令 - 快速访问工作流操作
- ✅(这个符号通常表示“正确”、“已确认”或“完成”的意思,但没有具体的中文翻译,因为它是一个图形符号) 执行挂钩(或:强制执行钩子) - 避免走捷径,确保质量
- ✅ 本地配置 - 项目特定的
.claude/设置
特点/特性
🎫 票务管理
- 从想法到完成的完整工单生命周期
- 上下文包包含所有相关信息
- 基于优先级的队列管理
- 依赖关系追踪
🤖 专业代理
- 看板实施者 - 严格遵守规范
- 看板规划工具 - 完整规格,附带需求文档(DoR)
- 看板评审员 - DoD(国防部)验证
📝 斜杠命令
/kanban-next- 获取下一个优先级最高的工单/kanban-status- 项目健康仪表盘/kanban-work- 展示当前工作
🔒 执行
- 无工单引用,不提交代码
- 未经测试,不许“完成”
- 没有备用实现
- 强制工作流程合规性
安装选项
交互模式(默认)
npx create-mcp-kanban在以下选项中选择:
- 完整安装 - MCP服务器 + 配置
- 灯光装置 - 仅配置
快速模式
npx create-mcp-kanban -y跳过提示,使用默认值。
自定义目录
npx create-mcp-kanban --dir ./my-project灯光装置
npx create-mcp-kanban --light仅配置,无MCP服务器。
工作流状态
Idea → Discovery → Research → Planning → Ready → InProgress → Review → Done“Definition of Ready (DoR)” 翻译为中文是:“准备就绪的定义(DoR)”
- 规格完整
- 定义了3+个不变量
- 5+验收标准
- 实施计划
- 测试框架
完成定义(DoD)
- 所有验收标准均已满足
- 所有测试均通过
- 没有备用代码
- 文档已更新
- 提交引用票据
项目结构
设置完成后,您的项目将包含:
your-project/
├── .claude/
│ ├── CLAUDE.md # Workflow instructions
│ ├── agents/ # Specialized agents
│ │ ├── kanban-implementer.md
│ │ ├── kanban-planner.md
│ │ └── kanban-reviewer.md
│ ├── commands/ # Slash commands
│ │ ├── kanban-next.md
│ │ ├── kanban-status.md
│ │ └── kanban-work.md
│ └── hooks/ # Enforcement hooks
│ ├── commit-blocker.sh
│ ├── test-enforcer.sh
│ └── fallback-detector.sh
├── src/ # MCP server source
├── data/
│ └── kanban.db # SQLite database
└── package.json # Dependencies用法
安装后:
- 重启Claude代码
- 检查状态:
/kanban-status - 获取第一张票:
/kanban-next - 开始工作!
可用的MCP工具
create_ticket- 创建新工单get_next_ticket- 获取最高优先级的工作claim_ticket- 主动负责get_context_bundle- 获取完整上下文update_ticket_spec- 定义规格set_status- 按照工作流程进行get_project_health- 健康指标get_project_status- 当前状态
命令行选项
Options:
-V, --version output the version number
-y, --yes Skip prompts and use defaults
--no-install Skip npm install
--light Light installation (configs only)
--dir
Target directory (default: current)
-h, --help display help for command要求
- Node.js >= 18.0.0
- npm 或 yarn
- 克劳德·科德
为什么要使用这个?
- 强制质量 - 没有捷径,没有妥协
- 完整上下文 - 所有信息集中一处
- 自动化工作流 - 聚焦于实施
- 项目隔离 - 每个项目都有自己的规则
- 反模式检测 - 防止不良行为
故障排除
未找到MCP服务器
- 安装后重启Claude代码
- 检查
~/.claude/mcp-config.json用于服务器注册 - 验证数据库是否存在于
data/kanban.db
钩子不起作用
- 检查钩子权限:
chmod +x .claude/hooks/*.sh - 验证(或检查)设置中的
~/.claude/settings.json
命令不可用
- 确保
.claude/目录存在于项目中 - 重启Claude代码以重新加载命令
贡献;做出贡献
欢迎贡献!请阅读我们的贡献指南。
许可证
麻省理工学院(MIT)
______________________________________________________________________
专为重视质量和流程的开发者打造,倾注爱心之作。
