Skip to main content
Glama
Sign In
Maestro

Maestro

by Matheus-Gama-deluna
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

MCP Maestro v6.0.0

Servidor MCP (Model Context Protocol) autônomo. Uma orquestração "Fat MCP" para desenvolvimento assistido por IA com Zero-API approach, auto-correção, TDD Invertido e pipelines nativos.

Status npm License Version

🆕 Novidades v6.0.0

🚀 Watcher Nativo Event-Driven (Sprint 5)

  • Ao invés de paradas bloqueantes a cada arquivo salvo, a ValidationPipeline agora corre local em background acionada por eventos chokidar do sistema operacional.

🛡️ TDD Invertido (Sprint 4)

  • Documentos de .orientacao-gate.md pré-gerados contendo as métricas de sucesso que a IA lê antes de escrever a funcionalidade. Sucesso ou Rollback compulsório se Score < 70.

⚙️ Auto-Correção Injetada (Sprint 1) e Smart Auto-Flow

  • Ao falhar um Gate, a IA é orientada ativamente pelo MCP sobre como corrigir no próprio erro, dispensando requisições extras.

  • Etapas "tecnicas" (Backend/Frontend/Deploy) auto-avançam (auto_flow) sem esperar comando do humano se os scores permitirem.

💰 5 Tools Paradigm

  • Com a abolição das APIs fechadas (Fat MCP), os 17 tools antigos condensaram-se em 5 Core Tools: maestro, executar, validar, analisar e contexto. Modos autônomos gerenciam o projeto de forma inteligente.

Ver CHANGELOG completo | Roadmap Master

Related MCP server: Gravitas-Core-MCP

🚀 Início Rápido

# 1. Certifique-se de configurar a extensao/MCP da sua IDE.
# 2. Use o tool de maestro para ligar e provisionar o projeto em um prompt
# EX: "Crie um projeto do Maestro neste diretório focado em gerenciar tarefas"

🔧 Configuração MCP via npx (local)

Use sempre a versão mais recente via npx (diretório atual):

{
  "mcpServers": {
    "maestro": {
      "command": "npx",
      "args": ["-y", "@maestro-ai/mcp-server@latest"],
      "disabled": false,
      "env": {}
    }
  }
}

Para especificar manualmente um diretório, adicione o caminho ao final de args:

{
  "mcpServers": {
    "maestro": {
      "command": "npx",
      "args": ["-y", "@maestro-ai/mcp-server@latest", "D:\\Meus\\Projetos"],
      "disabled": false,
      "env": {}
    }
  }
}

Fluxo de Desenvolvimento V6 (Fat MCP)

graph TD
    A[Setup npx na IDE] --> B[Tool: maestro - Cria Projeto]
    B --> C[Tool: contexto - Injeta Rules e Skills]
    C --> D[Fase 1: Produto]
    D --> E[Tool: executar - Salva e Submete]
    E --> F{Watcher Valida?}
    F -- Score > 70 --> G[Aplica Auto Flow p/ Prox Fase]
    F -- Score < 70 --> H[TDD Invertido - IA se Auto Corrige]
    H --> E

  1. Ative a MCP na IDE e chame a IA com sua intenção inicial.

  2. A IDE invocará o maestro({ acao: "criar_projeto" }) e injetará as skills e rules base.

  3. O desenvolvimento segue com a submissão de artefatos pelo executar.

  4. Os Gates são auto-checados pela ValidationPipeline (background watcher).

  5. Se scores forem atingidos, o Node.js assume a transição automaticamente (Zero-Pause) nas fases técnicas.

🛠️ Tools Disponíveis (V3+)

O número de comandos expostos foi drasticamente reduzido para otimizar overhead de tokens de função no prompt ("The 5 Core Tools").

Tool

Função Central

maestro

Engine de Iniciação e Status Check do projeto inteiro.

executar

Responsável pelas mutações (avancar com entregável, documentar draft salvar, etc).

validar

Portal manual para rodar a ValidationPipeline em qualquer Markdown desejado ou sob demanda de compliance.

analisar

Auditor de Technical Debt, performance e AI logic integrity

contexto

Permite à IDE recuperar imediatamente ADRs e a memória histórica contida em resumo.json sem desvios.

📚 Resources

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

📡 Endpoints

Endpoint

Método

Descrição

/

GET

Info do servidor

/health

GET

Health check

/mcp

GET

SSE connection (Streamable HTTP)

/mcp

POST

JSON-RPC endpoint

/resources

GET

Lista resources

/tools

GET

Lista tools

📁 Estrutura do Repositório

├── src/                    # Código do servidor MCP
│   ├── src/               # Código fonte TypeScript
│   ├── package.json
│   └── tsconfig.json
│
├── packages/cli/          # CLI npm (@maestro-ai/cli)
│
├── content/               # Conteúdo para IA
│   ├── specialists/      # Especialistas de IA
│   ├── templates/        # Templates de documentos
│   ├── guides/           # Guias práticos
│   ├── prompts/          # Prompts especializados
│   ├── skills/           # Skills para IA
│   ├── workflows/        # Workflows automatizados
│   └── rules/            # Regras para IDEs
│
├── docs/                  # Documentação técnica
│
├── Dockerfile
├── docker-compose.yml
└── docker-compose.dev.yml

💻 Desenvolvimento Local

Servidor MCP

cd src && npm install
npm run dev

CLI

cd packages/cli && npm install
npm run build
npm run dev -- init --ide gemini

Docker

# Produção
docker-compose up -d

# Desenvolvimento
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build

📖 Documentação

🤝 Contribuição

Contribuições são bem-vindas! Veja CONTRIBUTING.md.

📄 Licença

MIT License

This server cannot be deployed

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Maintenance

ActivityInactive
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers