<p align="center"> <a href="./assets/randomUserLogoRemake.svg"> <img src="./assets/randomUserLogoRemake.svg" align="c" height="100" /> </a> </p>

RandomUser MCP 服务器

一个 MCP 服务器，提供对 randomuser.me API 的增强访问，并具有自定义格式、密码生成和加权国籍分布等附加功能。

安装

克隆存储库：

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

# 安装依赖
npm install

# 构建项目
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",
    "values": ["name", "email", "phone"]
  },
  "format": {
    "type": "json",
    "structure": {
      "flattenObjects": true,
      "nameFormat": "full"
    }
  },
  "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: 新西兰
• RS: 塞尔维亚
• TR: 土耳其
• UA: 乌克兰
• US: 美国

开发

# 安装依赖
npm install

# 构建项目
npm run build

# 在开发模式下启动（带 watch 模式）
npm run dev

# 启动服务器
npm start

许可证

MIT