MCP Kanban Memory

Gerenciamento de Tarefas com Kanban MCP

Um conjunto de ferramentas MCP que fornece gerenciamento de tarefas baseado em kanban para desenvolvimento orientado por IA. Isso é semelhante a outras ferramentas MCP de gerenciamento de tarefas, com a estrutura adicional, regras e visibilidade de um sistema de gerenciamento de tarefas baseado em kanban.

A ideia principal é direcionar o agente de IA para documentar e salvar seu trabalho como tarefas em um quadro kanban, tanto na sessão de planejamento quanto nas sessões de execução.

Destaques

• Limites de capacidade de coluna / trabalho em andamento
• Banco de dados embutido (SQLite)
• Interface web para observar o progresso do fluxo de trabalho e para modificar tarefas manualmente
• Prompts predefinidos para iniciar e retomar um fluxo de trabalho

Uso

Use os prompts MCP para iniciar um projeto ou para fazer progresso em um projeto. Alternativamente, peça ao assistente LLM para registrar seu plano criando um quadro kanban. Para fazer progresso em uma sessão de acompanhamento, peça ao assistente para localizar um quadro kanban específico e retomar o trabalho nele.

Instalação

Clone este repositório e execute:

npm ci --prefix shared/db
npm ci --prefix mcp-server
npm run build --prefix shared/db
npm run build --prefix mcp-server

Em seguida, adicione a configuração do servidor MCP ao cliente MCP (ex.: Claude Desktop):

"mcpServers": {
    "kanban-mcp": {
        "command": "node",
        "args": [
            "/path/to/repo/mcp-server/dist/server.js"
        ],
        "env": {
            "MCP_KANBAN_DB_FOLDER_PATH": "/path/to/db"
        }
    }
}

Substitua /path/to/repo pela localização do repositório clonado.

Substitua /path/to/db por uma pasta que conterá os arquivos do banco de dados. Esta pode ser qualquer pasta com acesso de leitura/escrita. Ela será criada se não existir.

Instalação com Docker

Construa a imagem Docker:

docker build -t mcp/mcp-kanban .

Em seguida, adicione a configuração do servidor MCP ao cliente MCP (ex.: Claude Desktop):

"mcpServers": {
    "kanban-mcp": {
        "command": "docker",
        "args": [
            "run",
            "--rm",
            "-i",
            "-v",
            "/path/to/db:/mcp",
            "mcp/mcp-kanban"
        ]
    }
}

Substitua /path/to/db por uma pasta que conterá os arquivos do banco de dados. Esta pode ser qualquer pasta com acesso de leitura/escrita. Ela será criada se não existir.

Usando a interface web

Construa a interface web e o servidor web:

npm ci --prefix shared/db
npm run build --prefix shared/db

npm ci --prefix web-ui
npm ci --prefix web-server
npm run build --prefix web-ui
npm run build --prefix web-server

Execute o servidor web:

MCP_KANBAN_DB_FOLDER_PATH=/path/to/db npm run start --prefix web-server

Abra o navegador em http://localhost:8221

API

Ferramentas

• create-kanban-board

  • Crie um novo quadro kanban para planejar e acompanhar suas tarefas.
  • Entrada:
    • name (string): O nome do quadro
    • projectGoal (string): O objetivo do projeto.

• add-task-to-board

  • Adicione uma nova tarefa à coluna inicial (a fazer) de um quadro kanban.
  • Entrada:
    • boardId (string): O ID do quadro ao qual adicionar a tarefa
    • title (string): O título da tarefa
    • content (string): O conteúdo da tarefa em formato markdown

• move-task

  • Mova uma tarefa de uma coluna para outra, respeitando os limites de WIP.
  • Entrada:
    • taskId (string): O ID da tarefa a ser movida
    • targetColumnId (string): O ID da coluna para a qual mover a tarefa
    • reason (string, opcional): O motivo para mover a tarefa

• delete-task

  • Exclua uma tarefa.
  • Entrada:
    • taskId (string): O ID da tarefa a ser excluída

• get-board-info

  • Obtenha as informações completas de um quadro kanban, incluindo colunas e tarefas.
  • Entrada:
    • boardId (string): O ID do quadro para obter informações
  • Retorna informações detalhadas sobre o quadro, incluindo colunas e tarefas.

• get-task-info

  • Obtenha as informações completas de uma tarefa, incluindo seu conteúdo.
  • Entrada:
    • taskId (string): O ID da tarefa para obter informações
  • Retorna informações detalhadas sobre a tarefa, incluindo seu conteúdo.

• list-boards

  • Liste todos os quadros kanban no banco de dados.
  • Entrada: Nenhuma
  • Retorna uma lista de todos os quadros no banco de dados com seus nomes, horários de criação e objetivos.

Prompts

• create-kanban-based-project

  • Crie um quadro kanban para um projeto, faça perguntas para dividir o projeto em tarefas e adicione-as ao quadro.
  • Entrada:
    • description (string): A descrição do projeto

• make-progress-on-a-project

  • Faça progresso em um projeto existente localizando seu quadro kanban, selecionando a próxima tarefa e trabalhando nela.
  • Entrada:
    • description (string): A descrição do projeto