RandomUser MCP サーバー

カスタムフォーマット、パスワード生成、加重国籍分布などの追加機能により、randomuser.me API への拡張アクセスを提供する MCP サーバー。

インストール

リポジトリをクローンします。

git clone https://github.com/rycid/randomuserMCP.git
cd randomuserMCP

# Install dependencies
npm install

# Build the project
npm run build

Related MCP server: ntropy-mcp MCP Server

使用法

MCP 設定ファイル ( claude_desktop_config.jsonまたはcline_mcp_settings.json ) に追加します。

{
  "mcpServers": {
    "randomuser": {
      "command": "node",
      "args": ["path/to/randomuserMCP/build/index.js"]
    }
  }
}

利用可能なツール

get_random_user

カスタマイズ可能なオプションを持つランダムなユーザーを 1 人取得します。

{
  "gender": "female",
  "nationality": "US",
  "fields": {
    "mode": "include",
    "values": ["name", "email", "phone"]
  },
  "format": {
    "type": "json",
    "structure": {
      "flattenObjects": true,
      "nameFormat": "full"
    }
  },
  "password": {
    "charsets": ["special", "upper", "lower", "number"],
    "minLength": 8,
    "maxLength": 12
  }
}

複数のユーザーを取得する

重み付けされた国籍分布を持つ複数のランダムなユーザーを取得します。

{
  "count": 10,
  "nationality": ["US", "GB", "FR"],
  "nationalityWeights": {
    "US": 0.5,
    "GB": 0.3,
    "FR": 0.2
  },
  "fields": {
    "mode": "include",
    "values": ["name", "email", "nat"]
  },
  "format": {
    "type": "csv",
    "csv": {
      "delimiter": ",",
      "includeHeader": true
    }
  }
}

出力形式

サーバーは複数の出力形式をサポートしています。

JSON（デフォルト）

ネストされたオブジェクトまたはフラット化されたオブジェクト
カスタマイズ可能な名前の形式（フルネーム、名字と姓、別姓）
日付フォーマットオプション（ISO、UNIX、フォーマット済み）

CSV

カスタマイズ可能な区切り文字
オプションのヘッダー
自動的にフラット化されたデータ構造

SQL

複数の方言のサポート (MySQL、PostgreSQL、SQLite)
オプションのCREATE TABLE文
適切なエスケープと型処理

XML

標準XML形式
ネストされたデータ構造
特殊文字の適切なエスケープ

フィールド選択

特定のフィールドを含めるか除外する:

{
  "fields": {
    "mode": "include",  // or "exclude"
    "values": [
      "name",
      "phone",
      "email",
      "location",
      "picture",
      "dob",
      "login",
      "registered",
      "id",
      "cell",
      "nat"
    ]
  }
}

サポートされている国籍

AU: オーストラリア
BR: ブラジル
CA: カナダ
CH: スイス
DE: ドイツ
DK: デンマーク
ES: スペイン
FI: フィンランド
FR: フランス
GB: イギリス
IE: アイルランド
IN: インド
IR: イラン
MX: メキシコ
NL: オランダ
いいえ: ノルウェー
NZ: ニュージーランド
RS: セルビア
TR: トルコ
UA: ウクライナ
米国: アメリカ合衆国

発達

# Install dependencies
npm install

# Build the project
npm run build

# Start in development mode (with watch mode)
npm run dev

# Start the server
npm start