MCP Kanban Memory

Gestión de Tareas Kanban MCP

Un conjunto de herramientas MCP que proporciona gestión de tareas basada en kanban para el desarrollo impulsado por IA. Esto es similar a otras herramientas MCP de gestión de tareas, con la estructura, reglas y visibilidad adicionales de un sistema de gestión de tareas basado en kanban.

La idea principal es dirigir al agente de IA para que documente y guarde su trabajo como tareas en un tablero kanban, tanto en la sesión de planificación como en las sesiones de ejecución.

Características destacadas

• Límites de capacidad de columna / trabajo en progreso
• Base de datos integrada (SQLite)
• Interfaz web para observar el progreso del flujo de trabajo y para modificar tareas manualmente
• Prompts predefinidos para iniciar y reanudar un flujo de trabajo

Uso

Utilice los prompts de MCP para iniciar un proyecto o para avanzar en un proyecto. Alternativamente, pida al asistente LLM que registre su plan creando un tablero kanban. Para avanzar en una sesión posterior, pida al asistente que localice un tablero kanban específico y reanude el trabajo en él.

Instalación

Clone este repositorio y luego ejecute:

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

Luego agregue la configuración del servidor MCP al cliente MCP (por ejemplo, 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"
        }
    }
}

Reemplace /path/to/repo con la ubicación del repositorio clonado.

Reemplace /path/to/db con una carpeta que contendrá los archivos de la base de datos. Puede ser cualquier carpeta con acceso de lectura/escritura. Se creará si no existe.

Instalación con Docker

Construya la imagen de Docker:

docker build -t mcp/mcp-kanban .

Luego agregue la configuración del servidor MCP al cliente MCP (por ejemplo, Claude Desktop):

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

Reemplace /path/to/db con una carpeta que contendrá los archivos de la base de datos. Puede ser cualquier carpeta con acceso de lectura/escritura. Se creará si no existe.

Uso de la interfaz web

Construya la interfaz web y el 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

Ejecute el servidor web:

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

Abra el navegador en http://localhost:8221

API

Herramientas

• create-kanban-board

  • Crear un nuevo tablero kanban para planificar y realizar un seguimiento de sus tareas.
  • Entrada:
    • name (string): El nombre del tablero
    • projectGoal (string): El objetivo del proyecto.

• add-task-to-board

  • Agregar una nueva tarea a la columna inicial (por hacer) de un tablero kanban.
  • Entrada:
    • boardId (string): El ID del tablero al que se agregará la tarea
    • title (string): El título de la tarea
    • content (string): El contenido de la tarea en formato markdown

• move-task

  • Mover una tarea de una columna a otra, respetando los límites de trabajo en progreso.
  • Entrada:
    • taskId (string): El ID de la tarea a mover
    • targetColumnId (string): El ID de la columna a la que se moverá la tarea
    • reason (string, opcional): La razón para mover la tarea

• delete-task

  • Eliminar una tarea.
  • Entrada:
    • taskId (string): El ID de la tarea a eliminar

• get-board-info

  • Obtener la información completa de un tablero kanban, incluyendo columnas y tareas.
  • Entrada:
    • boardId (string): El ID del tablero del que se desea obtener información
  • Devuelve información detallada sobre el tablero, incluyendo columnas y tareas.

• get-task-info

  • Obtener la información completa de una tarea, incluyendo su contenido.
  • Entrada:
    • taskId (string): El ID de la tarea de la que se desea obtener información
  • Devuelve información detallada sobre la tarea, incluyendo su contenido.

• list-boards

  • Listar todos los tableros kanban en la base de datos.
  • Entrada: Ninguna
  • Devuelve una lista de todos los tableros en la base de datos con sus nombres, tiempos de creación y objetivos.

Prompts

• create-kanban-based-project

  • Crear un tablero kanban para un proyecto, hacer preguntas para dividir el proyecto en tareas y agregarlas al tablero.
  • Entrada:
    • description (string): La descripción del proyecto

• make-progress-on-a-project

  • Avanzar en un proyecto existente localizando su tablero kanban, seleccionando la siguiente tarea y trabajando en ella.
  • Entrada:
    • description (string): La descripción del proyecto