MockHero

@mockherodev/mcp-server

MockHero 的 MCP 服务 — 可通过 Claude Desktop、Claude Code、Cursor、Windsurf 和其他 AI Agent 生成逼真的测试数据。

无需 API 密钥也可使用：

• 无需密钥（免费预览）： 根据明确的表结构或小型模板，每次请求最多生成 100 条记录。架构检测、字段类型列表、模板和费用估算始终免费。
• 使用 MOCKHERO_API_KEY（推荐）： 通过自然语言提示词生成、更大规模的请求、付费套餐中的 CSV/SQL 输出，以及按用量计费的 Agent 套餐用量。

托管 Agent 端点

支持远程 Streamable HTTP MCP 的 Agent 无需安装 npm，可直接连接到：

https://mockhero.dev/mcp/agent

托管端点包含与本软件包相同的工具：费用估算、无需登录的 Polar 结账、结账状态查询、API 密钥领取、架构检测、模板和数据生成。对于经过身份验证的调用，可通过 Authorization: Bearer mh_YOUR_API_KEY（或 api_key 工具参数）传入密钥。

托管 Agent 端点

支持远程 Streamable HTTP MCP 的 Agent 可直接连接到：

https://mockhero.dev/mcp/agent

托管端点包含费用估算、无需登录的 Polar 结账、结账状态查询、API 密钥领取、架构检测、模板和经过身份验证的数据生成。

设置

Claude Desktop

添加到 ~/.claude/claude_desktop_config.json：

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

若要以免费预览模式运行，请完全省略 env 块。

Cursor

添加到项目中的 .cursor/mcp.json：

{
  "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

无需离开 Agent 即可获取 API 密钥（无需登录的结账）

无需注册或使用控制面板。Agent 套餐购买流程完全通过工具操作：

1. estimate_agent_usage — 先估算费用。Agent 套餐每天包含 500 条免费记录，此后每 100 条记录收费 $0.001（按每次请求向上取整），通过 Polar 按月结算，Polar 为登记商户。
2. create_agent_checkout — 传入账单邮箱；返回 Polar 结账 URL 和一次性 claim_token。用户在浏览器中完成付款。
3. check_agent_checkout_status — 使用 claim_token 轮询，直到 status 为 paid。
4. claim_agent_api_key — 使用 claim_token 换取 API 密钥。密钥只会返回一次 — 请妥善保存。
5. 从此处开始的推荐方式：设置 MOCKHERO_API_KEY=mh_... 并重启此服务。

更喜欢使用控制面板？可前往 mockhero.dev 免费注册。

工具

generate_test_data

根据结构化架构或自然语言描述生成逼真的测试数据。支持关系型外键、156 种字段类型、22 种区域设置，以及 JSON/CSV/SQL 输出。无需密钥即可免费生成最多 100 条记录的显式架构数据；提示词模式和更大规模的请求需要 MOCKHERO_API_KEY。

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

generate_from_template

根据预构建模板（ecommerce、blog、saas、social）生成数据 — 无需定义架构。较小的规模（例如 0.05）可保持在免费预览的 100 条记录限额内。

Use the ecommerce template at 2x scale with German locale

detect_schema

将 SQL CREATE TABLE 语句或 JSON 示例转换为 MockHero 的架构格式。免费，无需密钥。

list_field_types

列出所有 156 种受支持的字段类型及其说明和参数。免费，无需密钥。

list_templates

列出预构建的架构模板。免费，无需密钥。

estimate_agent_usage

在生成前估算 Agent 套餐费用：剩余每日免费额度、计费记录数、计费的 100 条记录单位数，以及预估费用。免费，无需密钥。

create_agent_checkout

为按用量计费的 Agent 套餐创建无需登录的 Polar 结账。返回结账 URL 和一次性 claim_token。

check_agent_checkout_status

通过 claim_token 轮询结账状态，直到付款完成。

claim_agent_api_key

付款后领取 API 密钥。仅返回一次 — 请保存并设置 MOCKHERO_API_KEY。

环境变量

变量	必需	描述
MOCKHERO_API_KEY	否	MockHero API 密钥（mh_...）。不提供此密钥时，生成将以免费预览模式运行（每次请求最多 100 条记录，且仅支持显式指定的架构/模板）。
MOCKHERO_API_BASE	否	MockHero API 的基础 URL。默认为 https://mockhero.dev。

定价

• 免费套餐： 每天 500 条记录，每次请求 100 条，输出为 JSON。
• Agent 套餐（无需登录，按用量计费）： 每天免费 500 条记录，之后每 100 条记录收费 $0.001，通过 Polar 按月结算（名义商家）。
• 完整定价：mockhero.dev/agent-pricing.json

链接

• 网站：mockhero.dev
• 文档：mockhero.dev/docs/mcp
• Agent 快速入门：mockhero.dev/agent-quickstart.json
• OpenAPI：mockhero.dev/openapi.json