MCP Dev Board

Kanban board for development task management, with automatic AI suggestions (Gemini 2.5 Flash) and an MCP Server to integrate it directly with Cursor or Claude Desktop.

Stack

• Python
• Django Rest Framework
• React
• PostgreSQL
• Docker
• Gemini
• MCP Server

Prerequisites

• Docker
• uv

Installation

1. Clone and configure environment variables

git clone <repo>
cd mcp-dev-board
cp .env.example .env

Edit .env and add your GEMINI_API_KEY (aistudio.google.com).

2. Start with Docker Compose

docker compose up --build

• Frontend: http://localhost:5173
• Backend API: http://localhost:8000/api/tasks/

API Endpoints

| Method | Endpoint | Description | | ------ | ------------------------ | ------------------------ | | GET | /api/tasks/ | List tasks | | POST | /api/tasks/ | Create task | | PATCH | /api/tasks/{id}/ | Update task | | DELETE | /api/tasks/{id}/ | Delete task | | POST | /api/tasks/ai-suggest/ | AI suggestion for a task |

Example: AI suggestion

curl -X POST http://localhost:8000/api/tasks/ai-suggest/ \
  -H "Content-Type: application/json" \
  -d '{"title": "Implement JWT authentication"}'

{
  "description": "Implement a JWT-based authentication system using djangorestframework-simplejwt.",
  "estimated_hours": 6,
  "subtasks": [
    "Install and configure simplejwt in Django",
    "Create login and refresh token endpoints",
    "Implement authentication middleware in the frontend"
  ]
}

MCP Server — Cursor Integration

The MCP Server allows Cursor to manage board tasks directly from the chat.

Configure in Cursor

Cursor Settings → MCP → New MCP Server:

{
  "mcp-dev-board": {
    "command": "uv",
    "args": [
      "--directory",
      "/absolute/path/to/project/mcp_server",
      "run",
      "server.py"
    ]
  }
}

Available tools

| Tool | Description | | -------------------- | --------------------------------------------------- | | list_tasks | List tasks, with optional filter by status | | create_task | Create a task with title, description, and priority | | update_task_status | Change the status of a task | | delete_task | Delete a task by ID | | get_board_summary | Board summary by status and priority |

Usage example in Cursor

You: "Create a task to implement the authentication endpoint with high priority"
Cursor: [uses create_task] → Task created on the board in real time