Kanban-MCP

A Model Context Protocol (MCP) server for managing Kanban-style tasks with analytics, built using Node.js, TypeScript, and MongoDB (via Mongoose).

Features

• Create, update, and manage tasks with priorities, tags, and statuses (todo, inProgress, done)

• Task analytics: lead time, cycle time, and status distribution

• MCP-compliant server with stdio transport

• MongoDB integration with user-based task filtering

• Task caching for performance

Related MCP server: Notion API MCP Server

Project Structure

Kanban-MCP/
├── src/
│   ├── index.ts            # Main MCP server logic
│   └── utils/
│       ├── mongoose.ts     # Mongoose DB utilities
│       ├── Task.d.ts       # Task type definitions
│       └── User.d.ts       # User type definitions
├── build/                  # Compiled JS output
├── .vscode/mcp.json        # MCP server config
├── package.json            # NPM dependencies and scripts
├── tsconfig.json           # TypeScript config

Getting Started

Prerequisites

• Node.js (v18+ recommended)

• MongoDB instance

Setup

1. Clone the repository:

   git clone <repo-url>
   cd Kanban-MCP

2. Install dependencies:

   npm install

3. Configure environment variables:

   • Create a .env file in the root directory with:

     MONGODB_URI=your_mongodb_uri
     KANBAN_USERNAME=your_username
     DBNAME=your_db_name

4. Build the project:

   npm run build

5. Start the MCP server: When starting the repo, VS Code will prompt you to start the MCP server.

Usage

• The server exposes MCP tools for creating, moving, and prioritizing tasks.

• Analytics can be retrieved via the tasks-analytics prompt.

• See src/index.ts for tool and prompt definitions.

Development

• Source code is in src/, compiled output in build/.

• TypeScript is used for type safety and modern JS features.

• Use the provided VS Code MCP config for local development.

License

MIT

Tech Stack

• Node.js: JavaScript runtime for server-side logic

• TypeScript: Strongly-typed language for safer code

• MongoDB: NoSQL database for task storage

• Mongoose: ODM for MongoDB integration

• VS Code MCP: Integration for Model Context Protocol tools