Backlog Manager MCP Server

by danielscholl
  • Linux
  • Apple

Integrations

  • Supports configuration through .env files to control server behavior, transport modes, and data storage settings

  • Provides containerized deployment options with Docker integration for running the backlog manager as an isolated service

  • Supports integration with n8n workflow automation platform through SSE transport, allowing automated task management from workflows

Servidor MCP del administrador de backlog

Un servidor MCP sencillo para el seguimiento de tareas y la gestión de trabajos atrasados para asistentes de IA (proyecto de hacking)

Tabla de contenido

Descripción general

Backlog Manager es un servidor MCP (Programación Consumible por Máquina) para la gestión de incidencias y tareas con un enfoque basado en archivos. Proporciona herramientas para que los agentes de IA y otros clientes creen incidencias, les añadan tareas y monitoreen su estado. Las incidencias representan solicitudes de funciones o errores de alto nivel, mientras que las tareas representan elementos de trabajo específicos necesarios para resolverlas.

Desarrollado con el protocolo MCP de Anthropic, admite transportes SSE y stdio para una integración flexible con asistentes de IA como Claude u otros clientes compatibles con MCP.

Características

  • Gestión de problemas : cree, enumere, seleccione y realice un seguimiento de problemas con descripciones
  • Seguimiento de tareas : agregue tareas a los problemas con títulos, descripciones y seguimiento del estado
  • Flujo de trabajo de estado : realice un seguimiento del progreso de las tareas a través de los estados Nuevo, En proceso y Listo
  • Almacenamiento basado en archivos : formato de almacenamiento JSON portátil para facilitar la realización de copias de seguridad y el control de versiones
  • Transporte flexible : compatibilidad con comunicación SSE (HTTP) y stdio
  • Compatibilidad con Docker : Ejecútelo en contenedores para una fácil implementación y aislamiento

Prerrequisitos

  • Python : 3.12 o superior
  • Gestor de paquetes : uv (recomendado) o pip
  • Docker : (opcional) para implementación en contenedores
  • Cliente MCP : Claude Code, Windsurf o cualquier otro cliente compatible con MCP

Instalación

Uso de uv (recomendado)

# Clone the repository git clone https://github.com/username/backlog-manager-mcp.git cd backlog-manager-mcp # Install dependencies uv pip install -e . # Verify installation uv run backlog-manager # This should start the server

Usando Docker

# Build the Docker image docker build -t backlog/manager --build-arg PORT=8050 . # Run the container docker run -p 8050:8050 backlog/manager # Verify container is running docker ps | grep backlog/manager

Configuración

Configure el comportamiento del servidor utilizando variables de entorno en un archivo .env :

# Create environment file from example cp .env.example .env

Ejemplo de contenido de archivo .env :

# Transport mode: 'sse' or 'stdio' TRANSPORT=sse # Server configuration (for SSE transport) HOST=0.0.0.0 PORT=8050 # Data storage TASKS_FILE=tasks.json
VariableDescripciónPor defectoRequerido
TRANSPORTProtocolo de transporte (sse o stdio)sseNo
HOSTHost al que vincularse cuando se utiliza el transporte SSE0.0.0.0No
PORTPuerto para escuchar cuando se utiliza el transporte SSE8050No
TASKS_FILERuta al archivo de almacenamiento de tareastasks.jsonNo

Ejecución del servidor

Iniciar el servidor (modo SSE)

# Using the CLI command uv run backlog-manager # Or directly with Python uv run src/backlog_manager/main.py

Debería ver un resultado similar a este:

INFO: Started server process [12345] INFO: Waiting for application startup. INFO: Application startup complete. INFO: Uvicorn running on http://0.0.0.0:8050 (Press CTRL+C to quit)

Nota : El servidor no admite el indicador --help ya que está diseñado como un servidor MCP, no como una aplicación CLI tradicional.

Usando el modo stdio

Al utilizar el modo stdio, no es necesario iniciar el servidor por separado: el cliente MCP lo iniciará automáticamente cuando esté configurado correctamente (consulte Integración con clientes MCP ).

Herramientas MCP

Backlog Manager expone las siguientes herramientas a través de MCP:

Gestión de problemas

HerramientaDescripciónParámetros
create_issueCrear un nuevo problemaname (cadena), description (cadena, opcional), status (cadena, opcional)
list_issuesMostrar todos los números disponiblesNinguno
select_issueEstablecer el problema activoname (cadena)
initialize_issueCrear o restablecer un problemaname (cadena), description (cadena, opcional), status (cadena, opcional)
update_issue_statusActualizar el estado del problemaname (cadena), status (cadena)

Gestión de tareas

HerramientaDescripciónParámetros
add_taskAgregar tarea a un problema activotitle (cadena), description (cadena, opcional)
list_tasksListar tareas en problemas activosstatus (cadena, opcional)
update_task_statusActualizar el estado de la tareatask_id (cadena), status (cadena)

Valores de estado

Las tareas y los problemas pueden tener uno de los siguientes estados:

  • New (predeterminado para nuevas tareas/problemas)
  • En InWork
  • Done (completado)

Integración con clientes MCP

Configuración de SSE

Una vez que tenga el servidor funcionando con el transporte SSE, conéctese a él utilizando esta configuración:

{ "mcpServers": { "backlog-manager": { "transport": "sse", "url": "http://localhost:8050/sse" } } }

Configuración de windsurf:

{ "mcpServers": { "backlog-manager": { "transport": "sse", "serverUrl": "http://localhost:8050/sse" } } }

Configuración de n8n:

Utilice host.docker.internal en lugar de localhost para acceder a la máquina host desde el contenedor n8n:

http://host.docker.internal:8050/sse

Python con configuración de Stdio

{ "mcpServers": { "backlog-manager": { "command": "python", "args": ["path/to/backlog-manager/src/backlog_manager/main.py"], "env": { "TRANSPORT": "stdio", "TASKS_FILE": "tasks.json" } } } }

Docker con configuración de Stdio

{ "mcpServers": { "backlog-manager": { "command": "docker", "args": ["run", "--rm", "-i", "-e", "TRANSPORT=stdio", "backlog/manager"], "env": { "TRANSPORT": "stdio" } } } }

Ejemplo

Backlog Manager está diseñado para funcionar a la perfección con asistentes de IA y ayudarte a organizar el trabajo de tu proyecto. El caso de uso más eficaz es que la IA lea las especificaciones y cree automáticamente un backlog estructurado.

Simplemente pregúntele a su asistente de IA:

Read the spec and create a backlog for features not completed.

El asistente de IA hará lo siguiente:

  1. Leer y analizar el documento de especificaciones
  2. Identificar características y componentes clave
  3. Crear problemas para las principales áreas funcionales
  4. Divida cada problema en tareas específicas
  5. Organiza todo en un backlog estructurado
-
security - not tested
F
license - not found
-
quality - not tested

Una herramienta de seguimiento de tareas y gestión de cartera de pedidos que permite a los asistentes de IA crear, organizar y rastrear problemas y tareas con flujo de trabajo de estado a través del protocolo MCP.

  1. Tabla de contenido
    1. Descripción general
      1. Características
        1. Prerrequisitos
          1. Instalación
            1. Uso de uv (recomendado)
            2. Usando Docker
          2. Configuración
            1. Ejecución del servidor
              1. Iniciar el servidor (modo SSE)
              2. Usando el modo stdio
            2. Herramientas MCP
              1. Gestión de problemas
              2. Gestión de tareas
              3. Valores de estado
            3. Integración con clientes MCP
              1. Configuración de SSE
              2. Python con configuración de Stdio
              3. Docker con configuración de Stdio
            4. Ejemplo

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                Provides tools for interacting with Targetprocess, a project management and agile planning platform, enabling AI assistants to search, create, and update project entities with proper validation.
                Last updated -
                5
                TypeScript
                MIT License
              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.
                Last updated -
                32
                80
                5
                TypeScript
                MIT License
                • Apple
              • -
                security
                F
                license
                -
                quality
                An MCP server that enables AI assistants to interact with the Plane project management platform, allowing them to manage workspaces, projects, issues, and comments through a structured API.
                Last updated -
                JavaScript
              • -
                security
                A
                license
                -
                quality
                AI-driven task management application that operates via MCP, enabling autonomous creation, organization, and execution of tasks with support for subtasks, priorities, and progress tracking.
                Last updated -
                Python
                MIT License
                • Linux

              View all related MCP servers

              ID: 5hql9gln1l