Real Fake Data

@przeslijmi/real-fake-data-mcp

Real Fake Data 用の Model Context Protocol サーバーです。AI アシスタント（Claude Desktop、Claude Code、Cursor、…）に、必要に応じてリアルな合成テストデータを提供します。有効な PESEL（正しいチェックサム付き）、NIP、REGON、IBAN、実在する都市や通りから取得した住所、そして EU 27 か国の人物名や会社名を生成できます。

出力は本物のように_見えます_が、偽物です。ステージング、デモ、シードデータに安全に使えます。

• 2 つのツールで、自動的に最新状態を維持します。 検出には list_generators、任意のジェネレーターの実行には generate を使います。API に新しいジェネレーターが追加されると、自動的に利用可能になります。クライアントのアップグレードは不要です。
• 薄く、ステートレスです。 HTTPS 経由でホストされた Real Fake Data API を呼び出します。データはローカルで生成も保存もされません。
• 必要に応じてシードを指定できます。 再現可能な出力を得るには seed を指定し、呼び出しごとにランダム化するには省略します。

インストール

グローバルインストールは不要です。npx 経由で MCP クライアントからパッケージを指定してください。stdio 経由で実行されるため、クライアントはサブプロセスとして起動します。

Claude Desktop / Claude Code

MCP サーバーの設定に追加します（claude_desktop_config.json、または claude mcp add を使用）。

{
  "mcpServers": {
    "real-fake-data": {
      "command": "npx",
      "args": ["-y", "@przeslijmi/real-fake-data-mcp"],
      "env": {
        "REAL_FAKE_DATA_API_KEY": "your-api-key"
      }
    }
  }
}

クライアントを再起動すると、どの会話でも real-fake-data ツールを利用できます。

Node 22 以降が必要です。

設定

クライアントは、サーバーの env を通じて設定を渡します。

変数	必須	説明
REAL_FAKE_DATA_API_KEY	いいえ	Authorization: Bearer <key> として送信される API キーです。リクエストは従量制プランで処理されます。省略すると、匿名用の経路が使われます。
REAL_FAKE_DATA_API_BASE_URL	いいえ	ホストされた API の接続先を上書きします。デフォルトは https://api.real-fake-data.com です。開発中はローカルの API を指定してください。

ツール

list_generators

利用可能なすべてのジェネレーターについて、id、description、supportedLocales を一覧表示します。最初にこれを呼び出して、generate で指定できる ID を確認してください。

あなた： どのような偽データジェネレーターが利用できますか？

Claude （list_generators を呼び出し） → pl.pesel、pl.company、pl.address、any.email、de.company-name、…

generate

1 つのジェネレーターを実行し、API の { data, meta } エンベロープを返します。

引数	型	説明
generator	string（必須）	list_generators にあるジェネレーター ID。例：pl.pesel または any.email。
options	Record<string, string | number | boolean>	ジェネレーター固有のクエリパラメーターです。デフォルトを使用する場合は省略します。
count	number	生成するレコード数です。1 件だけ生成する場合は省略します。（上限はプランによって適用されます。）
seed	number	再現可能な出力を得るためのシードです。呼び出しごとにランダム化する場合は省略します。

あなた： ステージング DB 用に、ポーランド人女性を 3 人生成してください。

Claude （{ generator: "pl.person", count: 3, options: { sex: "f" } } を指定して generate を呼び出し） → { name, surname, initials, birthDate, pesel } の 3 件のレコード。

options は、ジェネレーターが REST API で公開しているものと同じクエリパラメーターです。それぞれの説明は list_generators で確認でき、API ドキュメントにはすべて記載されています。例：NIP に対する { "format": "digits-only" }、住所を特定の地域に限定する { "teryt": "14" }、バリデーターのテスト用に意図的に誤ったチェックサムを取得する { "invalid": true }。

REST API との関係

このサーバーは、Playwright addon と REST API が提供するものと同じホスト型エンドポイントを利用する、薄い MCP フロントエンドです。ジェネレーター ID はルートに直接対応します。pl.pesel → GET /v1/pl/pesel、any.email → GET /v1/email となり、従量制、プランの上限、検証の動作はすべて同じです。AI アシスタントにテストデータを会話形式で生成させたい場合はこのパッケージを、コードから直接利用する場合は Playwright addon または REST API をお使いください。

ライセンス

MIT

---

このリポジトリは自動生成されています。非公開の上流モノレポから生成されています。ここでは issueを作成できますが、コードの変更は上流で行われ、再同期されます。このリポジトリへのプル リクエストは上流に適用され、このリポジトリに直接マージされることはありません。