Randomuser

🚀 RandomUser MCP サーバ

このサーバは、拡張機能を備えたMCPサーバです。ランダムユーザーの生成をサポートし、randomuser.me APIインターフェースを統合しています。カスタムフォーマット、パスワード生成、国籍の重み付け割り当てなどの機能が追加されています。

🚀 クイックスタート

このセクションでは、RandomUser MCPサーバの基本的な使い方を説明します。

📦 インストール

以下の手順に従って、サーバをインストールしてください。

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   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)

設定パラメータを通じて、単一のランダムユーザー情報を取得します。

{
  "gender": "female",
  "nationality": "US",
  "fields": {
    "mode": "include", // または "exclude"
    "values": ["name", "email", "phone"]
  },
  "format": {
    "type": "json",
    "structure": {
      "flattenObjects": true,
      "nameFormat": "full" // オプション: full, first_last, separate
    }
  },
  "password": {
    "charsets": ["special", "upper", "lower", "number"],
    "minLength": 8,
    "maxLength": 12
  }
}

複数のランダムユーザーを取得する (get_multiple_users)

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

{
  "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（デフォルト）

• ネストまたはフラットなオブジェクト構造を選択可能
• カスタム名前形式（full, first_last, separate）
• 複数の日付形式オプション（iso, unix, formatted）

CSV

• カスタム区切り文字
• ヘッダーを含めるか選択可能
• データ構造を自動的に扁平化

SQL

• 複数のデータベース方言（MySQL, PostgreSQL, SQLite）をサポート
• オプションでCREATE TABLE文を生成
• データのエスケープと型処理

XML

• 標準XML形式で出力
• ネストされたデータ構造をサポート
• 特殊文字を適切にエスケープ

フィールド選択

必要に応じて特定のフィールドを含めるか除外することができます：

{
  "fields": {
    "mode": "include", // または "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: オランダ
• NO: ノルウェー
• NZ: ニュージーランド
• SE: スウェーデン

🔧 技術詳細

リポジトリをクローンする

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

依存関係をインストールする

npm install

プロジェクトをビルドする

npm run build

🤝 貢献ガイド

貢献を歓迎します！詳細は 貢献ガイド を参照してください。

📄 ライセンス

このプロジェクトはMITライセンスに従います。詳細は LICENSE を参照してください。

📞 連絡先

ご連絡は、contact@rycid.com までお送りください。