Добро пожаловать в проект Kanban MCP! Этот проект объединяет доски Planka kanban с протоколом управления машиной Cursor (MCP), чтобы позволить помощникам ИИ, таким как Клод, управлять досками kanban.

Что такое Kanban MCP?

Kanban MCP - это мост между Planka (доской канбана с открытым исходным кодом) и протоколом управления машиной Cursor. Это позволяет помощникам ИИ, таким как Клод:

Просмотр и управление проектами, досками, списками и картами Создание и обновление задач Добавить комментарии к карточкам Перемещайте карты между списками ️ Отслеживание времени, затраченного на выполнение задач

• И намного больше!

Эта интеграция обеспечивает бесшовный рабочий процесс, в котором вы можете попросить Клода помочь вам управлять вашими задачами разработки, отслеживать прогресс и организовывать вашу работу.

Быстрый старт

Предпосылки

Docker для запуска Planka Git для клонирования репозитория Node.js (версия 18 или выше) и npm для разработки

###Установка

1. Клонировать это хранилище:

2.Установите зависимости и создайте код TypeScript:

3. Запуск контейнеров Planka:

4. Доступ к плате Планка Канбан:

• URL по умолчанию: http://localhost:3333
• По умолчанию:
• Электронная почта: [email protected]
• Пароль: демо

🔄 Kanban MCP

Welcome to the Kanban MCP project! 🎉 This project integrates Planka kanban boards with Cursor’s Machine Control Protocol (MCP) to enable AI assistants like Claude to manage your kanban boards.

🤔 What is Kanban MCP?

Kanban MCP is a bridge between Planka (an open-source kanban board) and Cursor’s Machine Control Protocol. It allows AI assistants like Claude to:

• 📋 View and manage projects, boards, lists, and cards
• ✅ Create and update tasks
• 💬 Add comments to cards
• 🔄 Move cards between lists
• ⏱️ Track time spent on tasks
• 🚀 And much more!

This integration enables a seamless workflow where you can ask Claude to help manage your development tasks, track progress, and organize your work.

🚦 Quick Start

📋 Prerequisites

• 🐳 Docker for running Planka
• 🔄 Git for cloning the repository
• 🟢 Node.js (version 18 or above) and npm for development

📥 Installation

1. Clone this repository:

git clone https://github.com/bradrisse/kanban-mcp.git
cd kanban-mcp

2. Install dependencies and build the TypeScript code:

npm install
npm run build

3. Start the Planka containers:

npm run up

4. Access the Planka Kanban board:

   • Default URL: http://localhost:3333
   • Default credentials:
     • Email: [email protected]
     • Password: demo

5. Configure Cursor to use the MCP server:

   • In Cursor, go to Settings > Features > MCP
   • Add a new MCP server with the following configuration:

   {
     "mcpServers": {
       "kanban": {
         "command": "node",
         "args": ["/path/to/kanban-mcp/dist/index.js"],
         "env": {
           "PLANKA_BASE_URL": "http://localhost:3333",
           "PLANKA_AGENT_EMAIL": "[email protected]",
           "PLANKA_AGENT_PASSWORD": "demo"
         }
       }
     }
   }
   

   • Replace /path/to/kanban-mcp with the actual absolute path to your kanban-mcp directory

Alternatively, you can use a project-specific configuration by creating a .cursor/mcp.json file in your project root with the same configuration.

For Docker-based deployment and other advanced options, see the Installation Guide.

📚 Documentation

For Users

• 🛠️ Installation Guide: How to install and configure Kanban MCP
• 📝 Usage Guide: How to use Kanban MCP with Claude
• 💡 Capabilities and Strategies: Detailed exploration of MCP server capabilities and LLM interaction strategies
• ⚠️ Troubleshooting: Solutions to common issues

For Developers