随机用户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许可证
麻省理工学院