AI导哈

随机用户生成服务

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

  • by rycid
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 rycid/randomusermcp

使用说明

随机用户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

用法

添加到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（默认）

  • 嵌套或扁平对象
  • 可定制的名称格式（完整、first_last、单独）
  • 日期格式选项（iso、unix、格式化）

CSV文件

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

SQL语言

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

可扩展置标语言

  • 标准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：爱尔兰
  • IN：印度
  • IR：伊朗
  • MX：墨西哥
  • 荷兰：荷兰
  • 否：挪威
  • 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

许可证

麻省理工学院

相关 MCP