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:
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.create_agent_checkout— informe um e-mail de cobrança; retorna uma URL de checkout Polar e umclaim_tokende uso único. Uma pessoa conclui o pagamento no navegador.check_agent_checkout_status— consulte com oclaim_tokenaté questatussejapaid.claim_agent_api_key— troque oclaim_tokenpela chave de API. A chave é retornada exatamente uma vez — armazene-a com segurança.- 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ável | Obrigatória | Descrição |
|---|---|---|
MOCKHERO_API_KEY | Não | Chave 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_BASE | Não | URL 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
- Site: mockhero.dev
- Documentação: mockhero.dev/docs/mcp
- Início rápido para agentes: mockhero.dev/agent-quickstart.json
- OpenAPI: mockhero.dev/openapi.json