Agile Planner MCP Server

Um servidor com inteligência artificial para gerar artefatos ágeis como backlogs, funcionalidades e histórias de usuário.

GitHub

Experimente este MCPPatrocinado

Documentação

Agile Planner MCP Server (v1.7.3) - Gerador de Backlog Ágil com IA

Agile Planner MCP gera automaticamente backlogs ágeis completos (Épicos, Histórias de Usuário, MVP, iterações) ou funcionalidades específicas a partir de uma descrição simples, diretamente no Windsurf, Cascade ou Cursor, sem necessidade de conhecimentos técnicos.

Últimas melhorias (v1.7.3):

Correção do modo MCP para generateFeature: Melhoria robusta na extração de histórias de usuário

Estrutura RULE 3 reforçada: Criação consistente das pastas epics/features/user-stories

Resolução do problema do Notepad no Windows: Normalização dos fluxos stderr/stdout no modo MCP

Logs de diagnóstico detalhados: Identificação mais fácil de problemas

Reestruturação do projeto: Organização clara dos arquivos de teste e temporários

Atualização dos guias de uso: Instruções completas para Windsurf, Claude e Cursor

Consulte CHANGELOG.md para detalhes completos.

Melhorias anteriores (v1.7.1):

Reformulação completa da documentação MCP: Documentação detalhada da arquitetura do servidor MCP com diagramas Mermaid.

Redução da complexidade cognitiva: Refatoração importante dos módulos críticos (json-parser, mcp-router).

Melhoria da robustez: Melhor gerenciamento de erros e testes de integração E2E otimizados.

Consulte CHANGELOG.md para detalhes.

❌ Sem o Agile Planner MCP

Criar backlogs ágeis manualmente é demorado e propenso a erros:

❌ Horas gastas escrevendo histórias de usuário, critérios de aceitação e tarefas
❌ Formatação e estrutura inconsistentes entre diferentes projetos
❌ Sem orientação clara de implementação para assistentes de codificação com IA
❌ Priorização e organização manuais sem estrutura estratégica

✅ Com o Agile Planner MCP

Gerenciamento centralizado de erros

Todos os retornos de erro das funções generateBacklog e generateBacklogDirect agora são formatados por handleBacklogError para garantir a uniformidade do JSON e a robustez da auditoria.
Os exemplos de erro exibem o formato: { success: false, error: { message: ... } }

O Agile Planner MCP gera backlogs ágeis completos e estruturados com anotações precisas guiadas por IA em segundos:

✅ Estrutura de backlog completa com épicos, funcionalidades, histórias de usuário e histórias órfãs
✅ Anotações otimizadas por IA que guiam a implementação passo a passo
✅ Acompanhamento de progresso com caixas de seleção de tarefas e gerenciamento de dependências
✅ Organização centralizada em uma pasta dedicada .agile-planner-backlog
✅ Organização inteligente de funcionalidades que associa automaticamente funcionalidades aos épicos relevantes

📑 Documentação

Esta documentação foi reorganizada para melhor navegação:

Guias do Usuário

Guia de integração MCP - Guia de integração com Claude, Cursor e Windsurf IDE
Guia de uso ideal - Guia de uso detalhado
Guia de migração - Guia para migrar de versões anteriores

Documentação para Desenvolvedores

Desenvolvimento - Guia de desenvolvimento
Especificações MCP - Especificação do protocolo MCP
Problemas conhecidos - Lista de problemas conhecidos e dívida técnica
Plano de refatoração - Plano detalhado de refatoração do código
Plano de refatoração de testes - Plano de correção dos testes
Roadmap - Roteiro das versões futuras
Arquitetura MCP - Arquitetura completa do servidor MCP
Sistema de geração Markdown - Arquitetura do gerador markdown
Formato do backlog - Especificação do formato JSON do backlog

Funções Auxiliares

createApiMessages(project) - Gera o par de mensagens sistema/usuário para a IA. O parâmetro project pode ser uma string do tipo "Nom: description" ou um objeto { name, description }.

Nota TDD: As asserções sobre erros devem verificar o formato unificado { success: false, error: { message: ... } }. Qualquer alteração no formato de erro exige a atualização dos testes de integração.

Documentação de Arquitetura

Design - Design geral do projeto
Formato do backlog - Formato do backlog gerado
Diagrama de validação do backlog - Diagrama de validação
Compatibilidade Multi-LLM - Compatibilidade com vários LLMs

🚦 Configuração no Windsurf / Cascade / Cursor

Peça ao seu administrador ou equipe técnica para adicionar este servidor MCP à configuração do seu espaço de trabalho:

Copie .env.example para .env e preencha sua OPENAI_API_KEY ou GROQ_API_KEY.

Opção 1: Usando uma instalação local

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

Opção 2: Usando o pacote NPM

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

🧠 Como Funciona

Descreva seu projeto em linguagem simples, fornecendo o máximo de detalhes possível.

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

O Agile Planner MCP processa sua descrição por meio de um pipeline robusto de validação:
- 🤖 Utiliza LLMs da OpenAI ou Groq para gerar a estrutura do backlog
- 🧪 Valida a estrutura contra um esquema JSON abrangente
- 🔍 Enriquece as funcionalidades com critérios de aceitação e tarefas
- 📝 Organiza as histórias em épicos e funcionalidades
- 🏗️ Cria uma estrutura completa de diretórios com arquivos markdown
Receba um backlog ágil totalmente estruturado em segundos:

Estrutura do diretório gerado

.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: As pastas planning/mvp e planning/iterations foram removidas. Todas as histórias de usuário são geradas em sua árvore épicos/funcionalidades ou em orphan-stories se não estiverem vinculadas a nenhuma funcionalidade/épico. O arquivo backlog.json não contém mais seções mvp ou iterations.

Todos os arquivos incluem instruções amigáveis para IA que orientam a implementação. Consulte a pasta de exemplos para ver exemplos de saída.

Comandos

O Agile Planner MCP suporta os seguintes comandos:

Gerar um 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..."

Gerar uma Funcionalidade 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"

🔄 Variáveis de Ambiente

Variável	Descrição	Padrão
`MCP_EXECUTION`	Obrigatória - Deve ser definida como "true" para o modo MCP	-
`OPENAI_API_KEY`	Chave da API OpenAI para gerar o backlog	-
`GROQ_API_KEY`	Chave alternativa da API Groq	-
`DEBUG`	Ativa o modo de depuração para logs adicionais	false
`TEST_MODE`	Ativa o modo de teste (geração simulada)	false
`AGILE_PLANNER_OUTPUT_ROOT`	Diretório base para a saída	diretório atual

📜 Licença

O Agile Planner MCP Server é licenciado sob a Licença MIT com Commons Clause. Consulte o arquivo LICENSE para obter o texto completo da licença.

👥 Suporte

Para suporte, abra uma issue no repositório GitHub ou entre em contato com seu administrador do Windsurf/Cascade/Cursor.

☕️ Apoie o Projeto

Se você achar este projeto útil, pode apoiar seu desenvolvimento comprando um café para mim no BuyMeACoffee!

🚀 Obtenha o Windsurf

Obrigado 🙏