Generate-Data

generate-data-mcp

Generate-Data.com 用 MCP サーバーです。エージェントから直接、合成データセットを生成したり、自然言語からスキーマを設計したり、プロジェクトを管理したりできます。

Generate-Data.com API を薄くラップした HTTP インターフェースです。このリポジトリには生成ロジックはありません。実際のサービスを利用するための、厳選されたエージェント向けインターフェースです。7 つのツール、一貫したレスポンス形式、バイナリーセーフな出力、すべての入力に対するサーバー側の検証を備えています。

インストール（30 秒でセットアップ）

まず Generate-Data.com の API キーが必要です。generate-data.com の Settings → API Access で作成してください。

{
  "mcpServers": {
    "generate-data": {
      "command": "uvx",
      "args": ["generate-data-mcp"],
      "env": {
        "GENERATE_DATA_API_KEY": "your-uuid-key-here"
      }
    }
  }
}

# run once, ad hoc:
uvx generate-data-mcp

# or install it as a persistent CLI tool:
uv tool install generate-data-mcp

pip install generate-data-mcp

git clone https://github.com/ns-3e/generate-data-mcp.git
cd generate-data-mcp
pip install -e ".[dev]"

動作確認

export GENERATE_DATA_API_KEY=your-key
generate-data-mcp

MCP クライアントから gd_get_usage を呼び出すと、利用プランと呼び出し回数が返されます。次に gd_list_field_types を呼び出すと、カテゴリーマップが返されます。

これでデータを生成する準備は完了です。

エージェントに 「EC の顧客の偽データを CSV で 50 行生成して」 のように頼むと、エージェントが gd_design_schema、続けて gd_generate_dataset を自動的に呼び出します。

クイックスタート

一般的なセッションは次のとおりです。エージェントがツールを自動的に連携させるため、必要な結果を説明するだけで使えます。

1. できることを確認します。 gd_list_field_types — カテゴリー別にまとめられたすべてのフィールドタイプを確認します。
2. スキーマを設計します。 gd_design_schema(prompt="E-commerce customers with name, email, and signup date") — 平易な英語の説明から fields 配列を提案します。
3. データを生成します。 gd_generate_dataset(fields=..., num_rows=10, format="csv") — 行データを返します。
4. 必要に応じて調整します。 messages（これまでの会話）と current_schema（前回の結果）の両方を渡して、もう一度 gd_design_schema を呼び出します。新しいスキーマを提案するのではなく、既存のスキーマを調整します。

すべてのツールは同じ形式のレスポンスを返します。成功時は {"ok": true, "summary": "...", "data": {...}}、失敗時は {"ok": false, "error": {"code": ..., "message": ...}} です。エラーには次に何をすべきかが必ず示され、生のスタックトレースは返されません。

ローカル開発

{
  "env": { "GENERATE_DATA_API_BASE_URL": "http://localhost:8000" }
}

ホストされた API ではなく、ローカルで実行中の Django バックエンドを指定します。

v1 からの移行

v2.0.0 ではすべてのツール名が変更されています（互換性のない変更）。旧名 → 新名：

• generate_data → gd_generate_dataset
• list_field_types → gd_list_field_types
• get_field_options → gd_get_field_type_options
• propose_schema → gd_design_schema（初回呼び出し。messages／current_schema は不要）
• refine_schema → gd_design_schema（messagesとcurrent_schema を両方渡す）
• get_api_usage → gd_get_usage
• list_projects → gd_list_projects（ページネーション対応：limit／offset）
• generate_project → gd_generate_project（バイナリー形式は、破損した utf-8 ではなく base64 エンコードで返されるようになりました）

リファレンス

7 つのツールすべてを、利用プラン別に紹介します。

無料プラン

• gd_generate_dataset — フィールドリストから合成データセットの行を生成します。format：csv、json、xml、parquet、または zip（バイナリ形式は Base64 エンコードで返されます）。
• gd_list_field_types — 利用可能なすべてのフィールドタイプをカテゴリ別に一覧表示します。引数は不要です。
• gd_get_field_type_options — 1 つのフィールドタイプの設定オプションスキーマを取得します。field_type は ^[a-z0-9_]+$ に一致する必要があります。
• gd_design_schema — 自然言語からデータセットのスキーマを設計するか、既存のスキーマを改善します。最初の提案から後続の会話ターンまで、1 つのツールで対応します。
• gd_get_usage — 現在の API キーの使用状況（本日の呼び出し回数、プラン、上限）を取得します。引数は不要です。

プレミアムプラン

プレミアム API キーが必要です。無料プランのキーでは tier_forbidden エラーが返されます。

• gd_list_projects — ユーザーのプロジェクトをページネーション付きで一覧表示します（limit／offset、既定値は 20／0）。
• gd_generate_project — プロジェクト内のすべてのテーブルを生成し、結果をダウンロードします。形式とバイナリに関するルールは gd_generate_dataset と同じです。

API キーのプラン別上限

上限はこの MCP サーバーではなく、Django API によって適用されます。

設定

トラブルシューティング

開発

git clone https://github.com/ns-3e/generate-data-mcp.git
cd generate-data-mcp
pip install -e ".[dev]"
pytest tests/ -v

API ドキュメント

ドキュメントは generate-data.com にあります。正規のリクエスト／レスポンス形式については、このリポジトリのツールの docstring（generate_data_mcp/server.py）を参照してください。