随机用户 MCP 服务器

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

安装

克隆存储库：

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

# Install dependencies
npm install

# Build the project
npm run build

Related MCP server: ntropy-mcp MCP Server

用法

添加到您的 MCP 设置文件（ claude_desktop_config.json或cline_mcp_settings.json ）：

{
  "mcpServers": {
    "randomuser": {
      "command": "node",
      "args": ["path/to/randomuserMCP/build/index.js"]
    }
  }
}

可用工具

获取随机用户

获取具有可自定义选项的单个随机用户。

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

获取多个用户

获取具有加权国籍分布的多个随机用户。

{
  "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（默认）

嵌套或扁平对象
可定制的姓名格式（全名、名字_姓氏、单独）
日期格式选项（iso、unix、格式化）

CSV

可自定义的分隔符
可选标头
自动扁平化数据结构

SQL

多种方言支持（MySQL、PostgreSQL、SQLite）
可选的 CREATE TABLE 语句
正确的转义和类型处理

XML

标准 XML 格式
嵌套数据结构
正确转义特殊字符

字段选择

包含或排除特定字段：

{
  "fields": {
    "mode": "include",  // or "exclude"
    "values": [
      "name",
      "phone",
      "email",
      "location",
      "picture",
      "dob",
      "login",
      "registered",
      "id",
      "cell",
      "nat"
    ]
  }
}

支持的国籍

AU：澳大利亚
BR：巴西
CA：加拿大
CH：瑞士
DE：德国
DK：丹麦
ES：西班牙
FI：芬兰
FR：法国
GB：英国
IE：爱尔兰
印度：印度
伊朗：伊朗
MX：墨西哥
NL：荷兰
否：挪威
NZ：新西兰
RS：塞尔维亚
TR：土耳其
UA：乌克兰
美国：美国

发展

# Install dependencies
npm install

# Build the project
npm run build

# Start in development mode (with watch mode)
npm run dev

# Start the server
npm start

执照

麻省理工学院

Install Server

A

license - permissive license

C

quality

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Appeared in Searches

A service for generating random names

RandomUser MCP Server