MockHero

Gere dados de teste relacionais realistas com 156 tipos de campo e 22 localidades.

Documentação

@mockherodev/mcp-server

Servidor MCP para MockHero — gere dados de teste realistas a partir do Claude Desktop, Claude Code, Cursor, Windsurf e outros agentes de IA.

Funciona com ou sem chave de API:

  • Sem chave (pré-visualização gratuita): gere até 100 registros por solicitação a partir de esquemas de tabela explícitos ou pequenos modelos. Detecção de esquema, listagem de tipos de campo, modelos e estimativas de custo são sempre gratuitos.
  • Com MOCKHERO_API_KEY (recomendado): geração por descrição em inglês simples, solicitações maiores, saída CSV/SQL em planos pagos e uso medido no plano de agente.

Endpoint de agente hospedado

Agentes que suportam MCP HTTP Streamable remoto podem pular a instalação do npm e conectar diretamente a:

https://mockhero.dev/mcp/agent

O endpoint hospedado inclui as mesmas ferramentas deste pacote: estimativa de custo, checkout Polar sem login, status do checkout, reivindicação de chave de API, detecção de esquema, modelos e geração de dados. Passe uma chave via Authorization: Bearer mh_YOUR_API_KEY (ou o argumento da ferramenta api_key) para chamadas autenticadas.

Endpoint de agente hospedado

Agentes que suportam MCP HTTP Streamable remoto podem conectar diretamente a:

https://mockhero.dev/mcp/agent

O endpoint hospedado inclui estimativa de custo, checkout Polar sem login, status do checkout, reivindicação de chave de API, detecção de esquema, modelos e geração de dados autenticada.

Configuração

Claude Desktop

Adicione a ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mockhero": {
      "command": "npx",
      "args": ["@mockherodev/mcp-server"],
      "env": {
        "MOCKHERO_API_KEY": "mh_live_your_key_here"
      }
    }
  }
}

Omita o bloco env completamente para executar no modo de pré-visualização gratuita.

Cursor

Adicione a .cursor/mcp.json no seu projeto:

{
  "mcpServers": {
    "mockhero": {
      "command": "npx",
      "args": ["@mockherodev/mcp-server"],
      "env": {
        "MOCKHERO_API_KEY": "mh_live_your_key_here"
      }
    }
  }
}

Claude Code

# Free preview mode
claude mcp add mockhero -- npx @mockherodev/mcp-server

# Authenticated
claude mcp add mockhero -- env MOCKHERO_API_KEY=mh_live_xxx npx @mockherodev/mcp-server

Obtenha uma chave de API sem sair do seu agente (checkout sem login)

Sem cadastro ou painel necessário. O fluxo de compra do plano de agente é totalmente orientado por ferramentas:

  1. estimate_agent_usage — estime o custo primeiro. O plano de agente inclui 500 registros gratuitos por dia, depois $0,001 por 100 registros (arredondado para cima por solicitação), cobrado mensalmente via Polar como Merchant of Record.
  2. create_agent_checkout — informe um e-mail de cobrança; retorna uma URL de checkout Polar e um claim_token de uso único. Uma pessoa conclui o pagamento no navegador.
  3. check_agent_checkout_status — consulte com o claim_token até que status seja paid.
  4. claim_agent_api_key — troque o claim_token pela chave de API. A chave é retornada exatamente uma vez — armazene-a com segurança.
  5. Reinicie este servidor com MOCKHERO_API_KEY=mh_... definido (caminho recomendado a partir daqui).

Prefere um painel? Cadastre-se gratuitamente em mockhero.dev.

Ferramentas

generate_test_data

Gere dados de teste realistas a partir de um esquema estruturado ou descrição em inglês simples. Chaves estrangeiras relacionais, 156 tipos de campo, 22 localidades, saída JSON/CSV/SQL. Esquemas explícitos de até 100 registros são gratuitos sem chave; modo de descrição e solicitações maiores precisam de MOCKHERO_API_KEY.

"Generate 50 users with German names and 200 orders linked to them"

generate_from_template

Gere dados a partir de um modelo pré-construído (ecommerce, blog, saas, social) — sem necessidade de definição de esquema. Escalas pequenas (ex.: 0.05) permanecem dentro da pré-visualização gratuita de 100 registros.

Use the ecommerce template at 2x scale with German locale

detect_schema

Converta instruções SQL CREATE TABLE ou amostras JSON para o formato de esquema do MockHero. Gratuito, sem necessidade de chave.

list_field_types

Liste todos os 156 tipos de campo suportados com descrições e parâmetros. Gratuito, sem necessidade de chave.

list_templates

Liste modelos de esquema pré-construídos. Gratuito, sem necessidade de chave.

estimate_agent_usage

Estime o custo do plano de agente antes de gerar: cota diária gratuita restante, registros cobráveis, unidades de 100 registros cobráveis e custo estimado em dólares. Gratuito, sem necessidade de chave.

create_agent_checkout

Crie um checkout Polar sem login para o plano de agente medido. Retorna uma URL de checkout e um claim_token de uso único.

check_agent_checkout_status

Consulte um checkout por claim_token até que seja pago.

claim_agent_api_key

Reivindique a chave de API após o pagamento. Retornada uma vez — armazene-a e defina MOCKHERO_API_KEY.

Variáveis de ambiente

VariávelObrigatóriaDescrição
MOCKHERO_API_KEYNãoChave de API do MockHero (mh_...). Sem ela, a geração roda no modo de pré-visualização gratuita (≤100 registros por solicitação, apenas esquemas/modelos explícitos).
MOCKHERO_API_BASENãoURL base da API do MockHero. Padrão https://mockhero.dev.

Preços

  • Plano gratuito: 500 registros/dia, 100 por solicitação, saída JSON.
  • Plano de agente (sem login, medido): 500 registros gratuitos/dia, depois $0,001 por 100 registros, cobrado mensalmente via Polar (Merchant of Record).
  • Preços completos: mockhero.dev/agent-pricing.json

Links