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
使用法
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
ライセンス
マサチューセッツ工科大学