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

支持的国家列表

• 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