random-profiles

random-profiles-mcp

Random Profiles API 用の MCP サーバーです。Claude などの AI エージェントから、架空のユーザープロフィールや企業を直接生成できます。

セットアップ — 設定不要

MCP サーバーをインストールして、話しかけるだけです。最初にプロフィールをリクエストすると、エージェントがメールアドレスを一度だけ尋ね、ユーザーに代わって無料のキーを取得し、ローカルにキャッシュして、以降のすべてのリクエストで使用します。キーは受領証としてメールでも送信されます。

Claude Code の MCP 設定（.mcp.json）に追加します。

{
  "mcpServers": {
    "random-profiles": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "random-profiles-mcp"]
    }
  }
}

Claude Code を再起動し、「ランダムなユーザープロフィールを5件ください」と尋ねてください。エージェントがキーの取得手続きを自動的に処理します。ブラウザーもコピー＆ペーストも不要です。

キーは ~/.random-profiles/config.json（モード 0600）にキャッシュされるため、マシンごとに一度だけ設定すれば済みます。

独自のキーを使う場合

すでに API キーをお持ちの場合（または特定のキーを使いたい場合）は、環境変数で設定して、キー取得の手順をすべて省略できます。

{
  "mcpServers": {
    "random-profiles": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "random-profiles-mcp"],
      "env": {
        "RANDOM_PROFILES_API_KEY": "rp_your_key_here"
      }
    }
  }
}

環境変数は、キャッシュ済みのキーより優先されます。

ツール

ツール	説明
claim_api_key	メールアドレスを使って無料の API キーを取得します（レスポンスにキーが含まれ、受領証としてエージェントからコピーがメールで送信されます）。キーが設定されていない初回実行時にのみ使用され、その後はキャッシュされます。
get_profiles	フィルター（件数、性別、国、年齢範囲、フィールド）を指定して、ランダムなユーザープロフィールを取得します
get_profile	UUID を指定して、単一のプロフィールを取得します
get_companies	フィルター（件数、業種、国、規模、フィールド）を指定して、ランダムな架空の企業を取得します
get_company	UUID を指定して、単一の企業を取得します
get_random_image	ランダムなプロフィール写真を取得します（JPEG、サイズ指定可）
get_image	UUID を指定して、特定のプロフィール写真を取得します（JPEG、サイズ指定可）
get_usage	API キーの使用状況、プラン、1日の上限を確認します（無制限アクセス用の buy-me-a-coffee support_url を含みます）

フィールドグループ

プロフィール：name、email、phone、identity、bio、social、physical、job、address、financial、network、documents、vehicle、contact、digital、interests、education、photo、relationships、meta

企業：name、industry、size、location、contact、social、financial、tech、leadership、legal、operations、product、relationships、meta

relationships グループは、リソース間を関連付ける UUID を返します。プロフィールには company_uuid と colleague_uuids が、企業には employee_uuids が含まれます。ツールを連携させてグラフを構築できます（例：「企業を5社取得してから、それぞれの従業員を取得して」）。

画像形式

get_profiles と get_companies は、オプションの photo_format／logo_format 引数（jpg または webp）を受け付けます。WebP は見た目の品質が同等でありながら JPG より約30％小さく、96％以上のブラウザーでサポートされています。最大限の互換性を確保するため、デフォルトは引き続き jpg です。

使用例

プロフィール

「米国のランダムなプロフィールを5件ください」

「ドイツから、25～35歳の女性のプロフィールを10件生成してください」

「名前とメールアドレスのフィールドだけを含むプロフィールを取得してください」

「ランダムなプロフィール写真を見せてください」

企業

「米国の架空のテクノロジー企業を5社ください」

「従業員数が51～200人のヘルスケア企業を10社生成してください」

「名前、業種、経営陣のフィールドだけを含む企業を20社取得してください」

「シードを42に固定して、英国の金融企業を3社ください」

「アイコングリッド用に、128px のロゴ付き企業を10社ください」

get_companies／get_company の logo_size 引数は、meta.logo_url のサイズバリエーションを選択します。プロフィールの photo_size と同じ形式です。有効な値：64、128、256、512、1024（デフォルト）。

環境変数

変数	必須	説明
RANDOM_PROFILES_API_KEY	はい	API キー（random-profiles.com で取得できます）

関連項目

• random-profiles-types — API レスポンスの形状を表す TypeScript 型です。TypeScript から API を直接呼び出す場合に利用できます。
• random-profiles — 同じ API 用の CLI です。

ライセンス

MIT