Seedfast

Preenche um banco de dados PostgreSQL com dados sintéticos de teste relacionalmente válidos, gerados a partir do seu esquema ativo, para que um agente possa popular um ambiente de desenvolvimento ou CI sem dados de produção. Planeje um seed, execute-o e acompanhe até a conclusão a partir do cliente. Executa como npx -y seedfast mcp e está publicado no registro oficial do MCP como st.seedfa/seedfast.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP Seedfast

O Seedfast preenche um banco de dados PostgreSQL com dados de teste realistas e relacionalmente válidos, gerados a partir do seu schema ao vivo, para que uma equipe que não pode colocar dados de produção em desenvolvimento ainda tenha um ambiente que se comporta como produção.

Este repositório é a superfície pública de integração para seu servidor MCP. Você encontrará a configuração do cliente, a referência de ferramentas e um teste de fumaça aqui. O mecanismo e a CLI em si são de código fechado e são distribuídos via npm e Homebrew.

Publicado no registro oficial MCP como st.seedfa/seedfast.

Instalação

Nada separado para instalar. O servidor MCP está embutido na CLI do Seedfast e roda diretamente de npx:

{
  "mcpServers": {
    "seedfast": {
      "command": "npx",
      "args": ["-y", "seedfast@latest", "mcp"],
      "env": {
        "SEEDFAST_API_KEY": "sfk_live_your_api_key_here"
      }
    }
  }
}

Esse bloco vai para claude_desktop_config.json para Claude Desktop, .cursor/mcp.json para Cursor, ou o arquivo equivalente para VS Code e Claude Code. Os caminhos por cliente estão no guia de configuração do MCP.

Prefere um binário local? Instale a CLI e aponte command para seedfast com args: ["mcp"] em vez disso:

brew install seedfast-ai/tap/seedfast   # macOS, Linux
npm install -g seedfast                 # any platform with Node.js

Configuração

Variável	Obrigatória	O que faz
`SEEDFAST_API_KEY`	sim	Chave de API criada no painel do Seedfast
`SEEDFAST_MCP_RUNS_DB`	não	Caminho para um arquivo SQLite. Sem ele, execuções e planos ficam em memória e desaparecem quando o servidor sai

Ferramentas

Treze ferramentas cobrem todo o ciclo de planejar um seed, executá-lo e inspecionar o que aconteceu.

Ferramenta	O que faz
`seedfast_doctor`	Verifica a saúde da CLI e se a autenticação está configurada
`seedfast_connections_test`	Testa uma conexão com o banco antes que qualquer coisa seja gravada
`seedfast_schema_info`	Lê o schema ao vivo do banco de dados de destino
`seedfast_plan`	Constrói um plano de seeding a partir de uma descrição de escopo
`seedfast_run`	Executa uma execução de seeding
`seedfast_run_status`	Consulta uma execução em andamento
`seedfast_run_cancel`	Aborta uma execução
`seedfast_run_answer`	Responde a uma pergunta que a execução levantou enquanto aguardava entrada
`seedfast_plans_list`	Lista planos salvos
`seedfast_plan_get`	Lê um plano salvo
`seedfast_plan_create`	Salva um novo plano
`seedfast_plan_update`	Edita um plano salvo
`seedfast_plan_delete`	Remove um plano salvo

Recursos

URI	Tipo de mídia	Conteúdo
`seedfast://runs/{runId}/summary`	`application/json`	Resumo de uma execução de seeding
`seedfast://runs/{runId}/log`	`application/x-ndjson`	Log de eventos de uma execução de seeding
`seedfast://runs/{runId}/pending_question`	`application/json`	A pergunta que uma execução está aguardando, enquanto está em `awaiting_input`
`seedfast://plans/{planId}`	`application/json`	Detalhes de um plano salvo

Prompts

Dois prompts acompanham o servidor: seed-production-db, que recebe um escopo e uma descrição do banco de dados de destino, e scope-examples, que transforma um caso de uso em escopos de exemplo.

Verificação

O teste de fumaça inicia o pacote publicado via stdio, completa um handshake do MCP e lista as ferramentas. Ele não precisa de chave de API, pois nunca alcança o backend:

node scripts/smoke-test.mjs

A saída esperada termina com a versão do protocolo que o servidor negociou e o número de ferramentas que ele anuncia.

Bancos de dados

O Seedfast funciona com PostgreSQL hoje. Ir primeiro para PostgreSQL foi deliberado, já que seu sistema de restrições e relacionamentos é o mais rico que existe, e é exatamente aí que gerar dados plausíveis fica difícil. Suporte para MySQL, Oracle e SQLite está em desenvolvimento.

Licença

MIT para o conteúdo deste repositório. A CLI do Seedfast é distribuída sob a mesma licença; seu mecanismo roda como um serviço hospedado.