MockHero

@mockherodev/mcp-server

MockHero の MCP サーバーです。Claude Desktop、Claude Code、Cursor、Windsurf、その他の AI エージェントから、現実的なテストデータを生成できます。

API キーがある場合もない場合も利用できます。

• キーなし（無料プレビュー）： 明示的なテーブルスキーマまたは小規模なテンプレートを使って、リクエストごとに最大 100 レコードを生成できます。スキーマ検出、フィールドタイプの一覧表示、テンプレート、コスト見積もりは常に無料です。
• MOCKHERO_API_KEY を設定（推奨）： 平易な英語のプロンプトによる生成、大規模なリクエスト、有料プランでの CSV／SQL 出力、従量制のエージェントプラン利用が可能です。

ホスト型エージェントエンドポイント

リモート Streamable HTTP MCP に対応したエージェントは、npm をインストールせずに、次のエンドポイントへ直接接続できます。

https://mockhero.dev/mcp/agent

ホスト型エンドポイントでは、このパッケージと同じツールを利用できます。コスト見積もり、ログイン不要の Polar チェックアウト、チェックアウト状況の確認、API キーの取得、スキーマ検出、テンプレート、データ生成が含まれます。認証付きの呼び出しには、Authorization: Bearer mh_YOUR_API_KEY（または api_key ツール引数）でキーを渡します。

ホスト型エージェントエンドポイント

リモート Streamable HTTP MCP に対応したエージェントは、次のエンドポイントへ直接接続できます。

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

エージェントから離れずに API キーを取得する（ログイン不要のチェックアウト）

サインアップやダッシュボードは不要です。エージェントプランの購入フローは、すべてツール経由で行えます。

1. estimate_agent_usage — まずコストを見積もります。エージェントプランでは、1 日あたり 500 レコードまで無料で、その後は 100 レコードごとに $0.001（リクエストごとに切り上げ）となり、Polar を通じて月次請求されます。Polar は Merchant of Record（販売者の代理）です。
2. create_agent_checkout — 請求先メールアドレスを渡します。Polar のチェックアウト URL と、一度だけ使用できる claim_token が返されます。ブラウザーで人間が支払いを完了します。
3. check_agent_checkout_status — status が paid になるまで、claim_token を使ってポーリングします。
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

生成前にエージェントプランのコストを見積もります。1 日の無料利用枠の残り、課金対象のレコード数、課金対象となる 100 レコード単位の数、推定費用を確認できます。無料で、キーは不要です。

create_agent_checkout

従量制エージェントプランのログイン不要の Polar チェックアウトを作成します。チェックアウト URL と、一度だけ使用できる claim_token が返されます。

check_agent_checkout_status

支払いが完了するまで、claim_token を使ってチェックアウトの状況をポーリングします。

claim_agent_api_key

支払い完了後に API キーを取得します。キーは一度だけ返されるため、安全な場所に保管して MOCKHERO_API_KEY に設定してください。

環境変数

変数	必須	説明
MOCKHERO_API_KEY	いいえ	MockHero API キー（mh_...）。設定しない場合、生成は無料のプレビューモードで実行されます（1 リクエストあたり最大 100 レコード、明示的なスキーマ／テンプレートのみ）。
MOCKHERO_API_BASE	いいえ	MockHero API のベース URL。デフォルトは https://mockhero.dev です。

料金

• 無料プラン： 1 日あたり 500 レコード、1 リクエストあたり 100 レコード、JSON 出力。
• エージェントプラン（ログイン不要、従量制）： 1 日あたり 500 レコードまで無料。その後は 100 レコードあたり $0.001 で、Polar（販売者責任者）を通じて毎月請求されます。
• 料金の詳細：mockhero.dev/agent-pricing.json

リンク

• ウェブサイト：mockhero.dev
• ドキュメント：mockhero.dev/docs/mcp
• エージェント向けクイックスタート：mockhero.dev/agent-quickstart.json
• OpenAPI：mockhero.dev/openapi.json