mcp-kanban

dennisonbertram/mcp-kanban

3.2

If you are the rightful owner of mcp-kanban and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Model Context Protocol (MCP) server is designed to facilitate a structured and automated Kanban workflow system, ensuring rigorous project management and quality assurance.

Tools
8
Resources
0
Prompts
0

create-mcp-kanban

🚀 Setup a complete Kanban workflow system with MCP server for Claude Code

Enforce rigorous Kanban workflow in your projects with automated ticket management, state machine enforcement, and comprehensive tooling for Claude Code.

Quick Start

npx create-mcp-kanban

Or install globally:

npm install -g create-mcp-kanban
create-mcp-kanban

What It Does

This tool sets up a complete Kanban workflow system in your project:

  • ✅ MCP Server - Full ticket management system with SQLite database
  • ✅ Specialized Agents - Planning, implementation, and review agents
  • ✅ Slash Commands - Quick access to workflow operations
  • ✅ Enforcement Hooks - Prevent shortcuts and ensure quality
  • ✅ Local Configuration - Project-specific .claude/ settings

Features

🎫 Ticket Management

  • Complete ticket lifecycle from Idea to Done
  • Context bundles with all relevant information
  • Priority-based queue management
  • Dependency tracking

🤖 Specialized Agents

  • kanban-implementer - Strict spec compliance
  • kanban-planner - Complete specifications with DoR
  • kanban-reviewer - DoD validation

📝 Slash Commands

  • /kanban-next - Get next priority ticket
  • /kanban-status - Project health dashboard
  • /kanban-work - Show current work

🔒 Enforcement

  • No commits without ticket reference
  • No "Done" without passing tests
  • No fallback implementations
  • Mandatory workflow compliance

Installation Options

Interactive Mode (Default)

npx create-mcp-kanban

Choose between:

  • Full installation - MCP server + configurations
  • Light installation - Configurations only

Quick Mode

npx create-mcp-kanban -y

Skip prompts and use defaults.

Custom Directory

npx create-mcp-kanban --dir ./my-project

Light Installation

npx create-mcp-kanban --light

Configurations only, no MCP server.

Workflow States

Idea → Discovery → Research → Planning → Ready → InProgress → Review → Done

Definition of Ready (DoR)

  • Specification complete
  • 3+ invariants defined
  • 5+ acceptance criteria
  • Implementation plan
  • Tests scaffolded

Definition of Done (DoD)

  • All acceptance criteria met
  • All tests passing
  • No fallback code
  • Documentation updated
  • Commit references ticket

Project Structure

After setup, your project will have:

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

Usage

After installation:

  1. Restart Claude Code
  2. Check status: /kanban-status
  3. Get first ticket: /kanban-next
  4. Start working!

MCP Tools Available

  • create_ticket - Create new tickets
  • get_next_ticket - Get highest priority work
  • claim_ticket - Take ownership
  • get_context_bundle - Get complete context
  • update_ticket_spec - Define specifications
  • set_status - Move through workflow
  • get_project_health - Health metrics
  • get_project_status - Current state

Command Line Options

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 <path>      Target directory (default: current)
  -h, --help        display help for command

Requirements

  • Node.js >= 18.0.0
  • npm or yarn
  • Claude Code

Why Use This?

  • Enforced Quality - No shortcuts, no compromises
  • Complete Context - All information in one place
  • Automated Workflow - Focus on implementation
  • Project Isolation - Each project has its own rules
  • Anti-Pattern Detection - Prevents bad practices

Troubleshooting

MCP Server Not Found

  • Restart Claude Code after installation
  • Check ~/.claude/mcp-config.json for server registration
  • Verify database exists at data/kanban.db

Hooks Not Working

  • Check hook permissions: chmod +x .claude/hooks/*.sh
  • Verify settings in ~/.claude/settings.json

Commands Not Available

  • Ensure .claude/ directory exists in project
  • Restart Claude Code to reload commands

Contributing

Contributions welcome! Please read our contributing guidelines.

License

MIT

Made with ❤️ for developers who value quality and process.