🚀 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