🚀 RandomUser MCP 服务器
RandomUser MCP 服务器是一个提供增强功能的 MCP 服务器，它支持随机用户生成，并且集成了 randomuser.me API 接口。该服务器增加了自定义格式化、密码生成以及按权重分配国籍等实用功能，能满足多样化的使用需求。
🚀 快速开始
安装步骤
- 克隆仓库：
git clone https://github.com/rycid/randomuserMCP.git cd randomuserMCP - 安装依赖项：
npm install - 构建项目：
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