MCP Server do Maestro v2.0 com otimizações, frontend-first e gerenciamento de tarefas
npm install @maestro-ai/mcp-serverServidor MCP (Model Context Protocol) para o Maestro - Guia de Desenvolvimento Assistido por IA.
Pacote: @maestro-ai/mcp-server@2.1.0
O Maestro agora é distribuído como pacote npm e executado localmente via npx, garantindo acesso direto aos arquivos do seu projeto.
1. Configure seu cliente MCP (ex: Gemini, VS Code, Cline):
``json`
{
"mcpServers": {
"maestro": {
"command": "npx",
"args": ["-y", "@maestro-ai/mcp-server@latest"],
"disabled": false,
"env": {}
}
}
}
2. O Maestro usará automaticamente o diretório de trabalho atual onde você estiver trabalhando.
3. Especificar diretório manualmente (se necessário):
`json`
{
"mcpServers": {
"maestro": {
"command": "npx",
"args": ["-y", "@maestro-ai/mcp-server@latest", "D:\\Meus\\Projetos"],
"disabled": false,
"env": {}
}
}
}
`bash1. Iniciar novo projeto (analisa e sugere classificação)
iniciar_projeto(
nome: "Meu App",
descricao: "Sistema de gestão de tarefas",
diretorio: "D:\\Projetos\\meu-app",
ide: "windsurf",
modo: "balanced" # economy | balanced | quality
)
$3
Ao confirmar um projeto, o Maestro injeta automaticamente:
`
meu-app/
├── .maestro/
│ ├── content/ ← Conteúdo injetado aqui
│ │ ├── specialists/ # Especialistas de cada fase
│ │ ├── templates/ # Modelos de entregáveis
│ │ ├── guides/ # Guias de apoio
│ │ └── prompts/ # Prompts por categoria
│ ├── estado.json # Estado do projeto
│ └── resumo.json # Memória do projeto
`$3
| Comando | Descrição |
|---------|-----------|
|
iniciar_projeto | Analisa e sugere classificação |
| confirmar_projeto | Cria projeto e injeta conteúdo |
| carregar_projeto | Carrega projeto existente |
| proximo | Salva entregável e avança fase |
| status | Retorna status completo |
| discovery | Coleta perguntas iniciais agrupadas e salva em estado.discovery |
| injetar_conteudo | Reinjeta conteúdo (use force:true) |---
Destaques do Changelog v2.1
- Modos de operação: economy / balanced / quality com otimizações automáticas
- Discovery agrupado para reduzir 40-75% dos prompts iniciais
- Multi-IDE consolidado via ide-paths.ts (Windsurf, Cursor, Antigravity)
- Correções de dependências e atualização do SDK MCP para 1.25.3---
Tools Disponíveis
| Tool | Descrição |
|------|-----------|
|
iniciar_projeto | Inicia um novo projeto com classificação |
| confirmar_projeto | Confirma criação e injeta conteúdo |
| carregar_projeto | Carrega projeto existente |
| proximo | Salva entregável e avança para próxima fase |
| status | Retorna status atual do projeto |
| validar_gate | Valida checklist antes de avançar fase |
| contexto | Obtém contexto completo do projeto |
| salvar | Salva artefatos do projeto |
| injetar_conteudo | Injeta conteúdo base no projeto |
| nova_feature | Fluxo para adicionar nova feature |
| corrigir_bug | Fluxo para correção de bugs |
| refatorar | Fluxo para refatoração de código |
| classificar | Classifica entregáveis |
| avaliar_entregavel | Avalia qualidade com score |---
📚 Resources Disponíveis
| URI | Descrição |
|-----|-----------|
|
maestro://especialista/{nome} | Especialistas de IA |
| maestro://template/{nome} | Templates de documentos |
| maestro://guia/{nome} | Guias práticos |
| maestro://prompt/{categoria}/{nome} | Prompts especializados |
| maestro://system-prompt | System prompt do Maestro |---
💻 Desenvolvimento Local
$3
`bash
cd src
npm install
`$3
`bash
Modo npx (STDIO) - principal
npm run devModo HTTP - apenas para testes
npm run dev:http
`$3
`bash
npm run build
npm run start:stdio # Modo npx
npm run start # Modo HTTP
`$3
`bash
Gerar pacote
npm run packTestar antes de publicar (usa diretório atual)
npx ./maestro-ai-mcp-server-1.0.0.tgzOu especificar diretório
npx ./maestro-ai-mcp-server-1.0.0.tgz D:\Projetos\teste
`$3
`bash
Instalar globalmente
npm install -g @maestro-ai/mcp-server@1.0.0Usar diretamente (usa diretório atual)
maestro-mcpOu especificar diretório
maestro-mcp D:\Projetos\meu-app
`$3
`bash
Publicar no npm (requer login)
npm publish --access public
`---
📋 Exemplo de Fluxo Completo (Modo npx)
`bash
1. Iniciar projeto
iniciar_projeto(
nome: "meu-app",
descricao: "Sistema de gestão de tarefas",
diretorio: "D:\\Projetos\\meu-app"
)2. Confirmar criação (injeta conteúdo automaticamente)
confirmar_projeto(
nome: "meu-app",
diretorio: "D:\\Projetos\\meu-app",
tipo_artefato: "product",
nivel_complexidade: "medio"
)3. Verificar status
status(
diretorio: "D:\\Projetos\\meu-app"
)4. Avançar fase
proximo(
entregavel: "# PRD - Produto\n\n## Problema\n...",
diretorio: "D:\\Projetos\\meu-app"
)
`---
🐳 Docker (Legado)
A imagem Docker continua disponível para o modo HTTP:
`bash
Produção
docker-compose up -dDesenvolvimento
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build
``---
MIT License - veja arquivo LICENSE para detalhes.