Randomuser

🚀 RandomUser MCP 服務器

RandomUser MCP 服務器是一個提供增強功能的 MCP 服務器，支持隨機用戶生成，並集成了 randomuser.me API 接口。該服務器增加了自定義格式化、密碼生成以及按權重分配國籍等功能，能夠滿足多樣化的隨機用戶數據需求。

🚀 快速開始

安裝步驟

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"
    ]
  }
}

支持的國家列表

🔧 技術細節

克隆倉庫

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

安裝依賴

npm install

構建項目

npm run build

🤝 貢獻指南

歡迎參與貢獻！請參考 貢獻指南 瞭解如何加入。

📄 許可證

本項目遵循 MIT 協議。查看 LICENSE 瞭解更多。

📞 聯繫方式

如需聯繫，請發送郵件至：contact@rycid.com