@maestro-ai/mcp-server 1.0.0 → 1.1.0

package/README.md

@@ -1,227 +1,266 @@
-# MCP Maestro
-
-Servidor MCP (Model Context Protocol) para o Maestro - Guia de Desenvolvimento Assistido por IA.
-
-## 🚀 Uso via npx (Recomendado)
-
-O Maestro agora é distribuído como pacote npm e executado localmente via `npx`, garantindo acesso direto aos arquivos do seu projeto.
-
-### Instalação e Configuração
-
-1. **Configure seu cliente MCP** (ex: Gemini, VS Code, Cline):
-
-```json
-{
-  "mcpServers": {
-    "maestro": {
-      "command": "npx",
-      "args": ["-y", "@maestro/mcp-server", "D:\\SEU\\DIRETÓRIO\\DE\\PROJETOS"],
-      "disabled": false,
-      "env": {}
-    }
-  }
-}
-```
-
-2. **Substitua `D:\\SEU\\DIRETÓRIO\\DE\\PROJETOS`** pelo caminho onde você cria projetos Maestro.
-
-### Fluxo de Uso
-
-```bash
-# 1. 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"
-)
-
-# 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. Trabalhar nas fases
-proximo()      # Avança para próxima fase
-status()       # Ver status completo
-salvar()       # Salva entregáveis
-```
-
-### Injeção Automática de Conteúdo
-
-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
-```
-
-### Comandos Principais
-
-| 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 |
-| `injetar_conteudo` | Reinjeta conteúdo (use `force:true`) |
-
----
-
-## 🌐 Servidor Público (Legado)
-
-O servidor HTTP público continua disponível para compatibilidade:
-
-```
-https://maestro.deluna.dev.br
-```
-
-> **Nota**: Recomendamos usar o modo npx para acesso completo aos arquivos locais.
-
-### Verificar Status
-
-```bash
-curl https://maestro.deluna.dev.br/health
-# Retorna: {"status":"ok","server":"mcp-maestro","version":"1.0.0"}
-```
-
----
-
-## �️ 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
-
-### Instalação
-
-```bash
-cd src
-npm install
-```
-
-### Desenvolvimento
-
-```bash
-# Modo npx (STDIO) - principal
-npm run dev
-
-# Modo HTTP - apenas para testes
-npm run dev:http
-```
-
-### Build e Produção
-
-```bash
-npm run build
-npm run start:stdio    # Modo npx
-npm run start          # Modo HTTP
-```
-
-### Teste Local do Pacote
-
-```bash
-# Gerar pacote
-npm run pack
-
-# Testar antes de publicar
-npx ./maestro-mcp-server-1.0.0.tgz D:\Projetos\teste
-```
-
-### Publicação
-
-```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 -d
-
-# Desenvolvimento
-docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build
-```
-
----
-
-## 📄 Licença
-
-MIT License - veja arquivo LICENSE para detalhes.
+# MCP Maestro
+
+Servidor MCP (Model Context Protocol) para o Maestro - Guia de Desenvolvimento Assistido por IA.
+
+**Pacote**: `@maestro-ai/mcp-server@1.0.0`
+
+## 🚀 Uso via npx (Recomendado)
+
+O Maestro agora é distribuído como pacote npm e executado localmente via `npx`, garantindo acesso direto aos arquivos do seu projeto.
+
+### Instalação e Configuração
+
+1. **Configure seu cliente MCP** (ex: Gemini, VS Code, Cline):
+
+   ```json
+   {
+     "mcpServers": {
+       "maestro": {
+         "command": "npx",
+         "args": ["-y", "@maestro-ai/mcp-server@1.0.0"],
+         "disabled": false,
+         "env": {}
+       }
+     }
+   }
+   ```
+
+2. **O Maestro usará automaticamente o diretório de trabalho atual** onde você estiver trabalhando.
+
+3. **Instalação direta (opcional)**:
+   ```bash
+   npm install -g @maestro-ai/mcp-server@1.0.0
+   ```
+
+4. **Especificar diretório manualmente (se necessário)**:
+   ```json
+   {
+     "mcpServers": {
+       "maestro": {
+         "command": "npx",
+         "args": ["-y", "@maestro-ai/mcp-server@1.0.0", "D:\\Meus\\Projetos"],
+         "disabled": false,
+         "env": {}
+       }
+     }
+   }
+   ```
+
+
+
+### Fluxo de Uso
+
+```bash
+# 1. 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"
+)
+
+# 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. Trabalhar nas fases
+proximo()      # Avança para próxima fase
+status()       # Ver status completo
+salvar()       # Salva entregáveis
+```
+
+### Injeção Automática de Conteúdo
+
+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
+```
+
+### Comandos Principais
+
+| 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 |
+| `injetar_conteudo` | Reinjeta conteúdo (use `force:true`) |
+
+---
+
+## 🌐 Servidor Público (Legado)
+
+O servidor HTTP público continua disponível para compatibilidade:
+
+```
+https://maestro.deluna.dev.br
+```
+
+> **Nota**: Recomendamos usar o modo npx para acesso completo aos arquivos locais.
+
+### Verificar Status
+
+```bash
+curl https://maestro.deluna.dev.br/health
+# Retorna: {"status":"ok","server":"mcp-maestro","version":"1.0.0"}
+```
+
+---
+
+## �️ 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
+
+### Instalação
+
+```bash
+cd src
+npm install
+```
+
+### Desenvolvimento
+
+```bash
+# Modo npx (STDIO) - principal
+npm run dev
+
+# Modo HTTP - apenas para testes
+npm run dev:http
+```
+
+### Build e Produção
+
+```bash
+npm run build
+npm run start:stdio    # Modo npx
+npm run start          # Modo HTTP
+```
+
+### Teste Local do Pacote
+
+```bash
+# Gerar pacote
+npm run pack
+
+# Testar antes de publicar (usa diretório atual)
+npx ./maestro-ai-mcp-server-1.0.0.tgz
+
+# Ou especificar diretório
+npx ./maestro-ai-mcp-server-1.0.0.tgz D:\Projetos\teste
+```
+
+### Instalação Global
+
+```bash
+# Instalar globalmente
+npm install -g @maestro-ai/mcp-server@1.0.0
+
+# Usar diretamente (usa diretório atual)
+maestro-mcp
+
+# Ou especificar diretório
+maestro-mcp D:\Projetos\meu-app
+```
+
+### Publicação
+
+```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 -d
+
+# Desenvolvimento
+docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build
+```
+
+---
+
+## 📄 Licença
+
+MIT License - veja arquivo LICENSE para detalhes.