@justmpm/flow

MCP Server para instruções faseadas. Entregue comandos em fases, não tudo de uma vez.

Instalação

npm install -g @justmpm/flow

Uso

Adicione ao seu cliente MCP:

{
  "mcpServers": {
    "flow": {
      "command": "flow"
    }
  }
}

Tools

| Tool | Descrição | Parâmetros | | ------ | ----------------------- | ---------------------------------- | | get | Instruções de uma fase | command: string, phase: number | | info | Estrutura do flow | command: string | | list | Lista flows disponíveis | (sem parâmetros) |

Exemplos de Uso

Listar flows disponíveis

list

Ver estrutura de um flow

info command="audit"

Obter instruções de uma fase

get command="audit" phase=1

Criando um Flow

Diretório: ~/.config/flow/

.config/flow/
└── meu-comando/
    ├── flow.json
    ├── 1.md
    ├── 2.md
    └── ...

flow.json:

{
  "name": "meu-comando",
  "description": "O que este comando faz",
  "totalPhases": 3,
  "phases": [
    { "number": 1, "title": "Preparação" },
    { "number": 2, "title": "Execução" },
    { "number": 3, "title": "Validação" }
  ]
}

1.md, 2.md, 3.md: Conteúdo markdown de cada fase.

Exemplo de Resposta

Tool get

╔════════════════════════════════════════════════════════════════╗
║  FASE 1/3: Preparação                                          ║
╚════════════════════════════════════════════════════════════════╝

[conteúdo das instruções da fase 1...]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PRÓXIMA FASE: get command="audit" phase=2
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Tool info

╔════════════════════════════════════════════════════════════════╗
║  audit                                                         ║
╚════════════════════════════════════════════════════════════════╝

Auditoria profissional de código

FASES (5):
  1. Setup
  2. Análise Estática
  3. Revisão Manual
  4. Relatório
  5. Correções

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INICIAR: get command="audit" phase=1
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Mensagem de Erro (validação)

╔════════════════════════════════════════════════════════════════╗
║                    ERRO DE VALIDAÇÃO                           ║
╚════════════════════════════════════════════════════════════════╝

┌─────────────────────────────────────────┐
│ PARÂMETROS ESPERADOS:                   │
│   ├── command: string (obrigatório)     │
│   │   └── ex: audit                     │
│   └── phase: number (obrigatório)       │
│       └── ex: 1                         │
└─────────────────────────────────────────┘

SEU INPUT:
  ❌ phase: Required (recebido: undefined)

EXEMPLO (formato MCP):
<function_calls>
<invoke name="get">
  <parameter name="command">audit</parameter>
  <parameter name="phase">1</parameter>
</invoke>
</function_calls>

CLI

flow --help       # Ajuda completa
flow --version    # Versão
flow              # Inicia servidor MCP

Configuração Avançada

Diretório personalizado:

export FLOWS_DIR="/caminho/customizado"

Licença

MIT © Koda AI Studio