Agile Planner MCP Server

Un servidor impulsado por IA para generar artefactos ágiles como backlogs, funcionalidades e historias de usuario.

Documentación

Agile Planner MCP Server (v1.7.3) - Generador de Backlogs Ágiles Impulsado por IA

Agile Planner MCP genera automáticamente backlogs ágiles completos (Épicas, Historias de Usuario, MVP, iteraciones) o características específicas a partir de una descripción simple, directamente en Windsurf, Cascade o Cursor, sin necesidad de conocimientos técnicos.

Últimas mejoras (v1.7.3):

Corrección del modo MCP para generateFeature: Mejora robusta de la extracción de historias de usuario

Estructura RULE 3 reforzada: Creación coherente de carpetas epics/features/user-stories

Resolución del problema de Notepad en Windows: Normalización de los flujos stderr/stdout en modo MCP

Registros de diagnóstico detallados: Identificación más fácil de problemas

Reestructuración del proyecto: Organización clara de archivos de prueba y temporales

Actualización de las guías de uso: Instrucciones completas para Windsurf, Claude y Cursor

Consulta CHANGELOG.md para más detalles.

Mejoras anteriores (v1.7.1):

Rediseño completo de la documentación MCP: Documentación detallada de la arquitectura del servidor MCP con diagramas Mermaid.

Reducción de la complejidad cognitiva: Refactorización importante de los módulos críticos (json-parser, mcp-router).

Mejora de la robustez: Mejor gestión de errores y pruebas de integración E2E optimizadas.

Consulta CHANGELOG.md para más detalles.

❌ Sin Agile Planner MCP

Crear backlogs ágiles manualmente consume tiempo y es propenso a errores:

❌ Horas dedicadas a escribir historias de usuario, criterios de aceptación y tareas
❌ Formato y estructura inconsistentes entre diferentes proyectos
❌ Sin guía de implementación clara para asistentes de codificación con IA
❌ Priorización y organización manual sin un marco estratégico

✅ Con Agile Planner MCP

Gestión de errores centralizada

Todos los retornos de error de las funciones generateBacklog y generateBacklogDirect ahora están formateados por handleBacklogError para garantizar la uniformidad del JSON y la robustez de la auditoría.
Los ejemplos de error muestran el formato: { success: false, error: { message: ... } }

Agile Planner MCP genera backlogs ágiles completos y estructurados con anotaciones precisas guiadas por IA en segundos:

✅ Estructura de backlog completa con épicas, características, historias de usuario e historias huérfanas
✅ Anotaciones optimizadas por IA que guían la implementación paso a paso
✅ Seguimiento del progreso con casillas de verificación de tareas y gestión de dependencias
✅ Organización centralizada en una carpeta dedicada .agile-planner-backlog
✅ Organización inteligente de características que asocia automáticamente las características con las épicas relevantes

📑 Documentación

Esta documentación ha sido reorganizada para una mejor navegación:

Guías de Usuario

Guía de integración MCP - Guía de integración con Claude, Cursor y Windsurf IDE
Guía de uso óptimo - Guía de uso detallada
Guía de migración - Guía para migrar desde versiones anteriores

Documentación para Desarrolladores

Desarrollo - Guía de desarrollo
Especificaciones MCP - Especificación del protocolo MCP
Problemas conocidos - Lista de problemas conocidos y deuda técnica
Plan de refactorización - Plan detallado de refactorización del código
Plan de refactorización de pruebas - Plan de corrección de pruebas
Hoja de ruta - Hoja de ruta de versiones futuras
Arquitectura MCP - Arquitectura completa del servidor MCP
Sistema de generación Markdown - Arquitectura del generador markdown
Formato del backlog - Especificación del formato JSON de backlog

Funciones Auxiliares

createApiMessages(project) - Genera el par de mensajes sistema/usuario para la IA. El parámetro project puede ser una cadena de tipo "Nom: description" o un objeto { name, description }.

Nota TDD : Las aserciones sobre errores deben verificar el formato unificado { success: false, error: { message: ... } }. Cualquier modificación del formato de error requiere la actualización de las pruebas de integración.

Documentación de Arquitectura

Diseño - Diseño general del proyecto
Formato de backlog - Formato del backlog generado
Diagrama de validación de backlog - Diagrama de validación
Compatibilidad Multi-LLM - Compatibilidad con múltiples LLMs

🚦 Configuración en Windsurf / Cascade / Cursor

Solicita a tu administrador o equipo técnico que agregue este servidor MCP a la configuración de tu espacio de trabajo:

Copia .env.example a .env y completa tu OPENAI_API_KEY o GROQ_API_KEY.

Opción 1: Usando una instalación local

{
  "mcpServers": {
    "agile-planner": {
      "command": "node",
      "args": ["D:/path/to/agile-planner/server/index.js"],
      "env": {
        "MCP_EXECUTION": "true",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

Opción 2: Usando el paquete NPM

{
  "mcpServers": {
    "agile-planner": {
      "command": "npx",
      "args": ["agile-planner-mcp-server"],
      "env": {
        "MCP_EXECUTION": "true",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

🧠 Cómo Funciona

Describe tu proyecto en lenguaje natural, proporcionando la mayor cantidad de detalles posible.

SaaS task management system for teams with Slack integration, 
mobile support, and GDPR compliance.

Agile Planner MCP procesa tu descripción a través de un pipeline de validación robusto:
- 🤖 Utiliza LLMs de OpenAI o Groq para generar la estructura del backlog
- 🧪 Valida la estructura contra un esquema JSON completo
- 🔍 Mejora las características con criterios de aceptación y tareas
- 📝 Organiza las historias en épicas y características
- 🏗️ Crea una estructura de directorios completa con archivos markdown
Recibe un backlog ágil completamente estructurado en segundos:

Estructura del directorio generado

.agile-planner-backlog/
├── epics/
│   └── [epic-slug]/
│       ├── epic.md
│       └── features/
│           └── [feature-slug]/
│               ├── feature.md
│               └── user-stories/
│                   ├── [story-1].md
│                   └── [story-2].md
├── orphan-stories/
│   ├── [story-orpheline-1].md
│   └── [story-orpheline-2].md
└── backlog.json

Nota : Las carpetas planning/mvp y planning/iterations se eliminan. Todas las historias de usuario se generan en su árbol épicas/características o en orphan-stories si no están vinculadas a ninguna característica/épica. El archivo backlog.json ya no contiene secciones mvp o iterations.

Todos los archivos incluyen instrucciones amigables para IA que guían la implementación. Consulta la carpeta de ejemplos para ver salidas de muestra.

Comandos

Agile Planner MCP admite los siguientes comandos:

Generar un Backlog Completo

// In Windsurf or Cascade
mcp0_generateBacklog({
  projectName: "My Project",
  projectDescription: "A detailed description of the project...",
  outputPath: "optional/custom/path"
})

// CLI
npx agile-planner-mcp-server backlog "My Project" "A detailed description of the project..."

Generar una Característica Específica

// In Windsurf or Cascade
mcp0_generateFeature({
  featureDescription: "A detailed description of the feature to generate",
  storyCount: 3,  // Optional: number of user stories to generate (min: 3)
  businessValue: "High", // Optional: business value of this feature
  iterationName: "iteration-2", // Optional: target iteration (default: 'next')
  epicName: "Optional Epic Name", // Optional: specify an epic or let the system find/create one
  outputPath: "optional/custom/path" // Optional: custom output directory
})

// CLI
npx agile-planner-mcp-server feature "A detailed description of the feature to generate"

🔄 Variables de Entorno

Variable	Descripción	Valor Predeterminado
`MCP_EXECUTION`	Requerida - Debe establecerse en "true" para el modo MCP	-
`OPENAI_API_KEY`	Clave API de OpenAI para generar el backlog	-
`GROQ_API_KEY`	Clave API alternativa de Groq	-
`DEBUG`	Habilita el modo de depuración para registros adicionales	false
`TEST_MODE`	Habilita el modo de prueba (generación simulada)	false
`AGILE_PLANNER_OUTPUT_ROOT`	Directorio base para la salida	directorio actual

📜 Licencia

Agile Planner MCP Server está licenciado bajo la Licencia MIT con Commons Clause. Consulta el archivo LICENSE para ver el texto completo de la licencia.

👥 Soporte

Para soporte, abre un problema en el repositorio de GitHub o contacta a tu administrador de Windsurf/Cascade/Cursor.

☕️ Apoya el Proyecto

Si encuentras útil este proyecto, puedes apoyar su desarrollo invitándome a un café en BuyMeACoffee!

🚀 Obtén Windsurf

¡Gracias 🙏