random-profiles

random-profiles-mcp

适用于 Random Profiles API 的 MCP 服务 — 可直接通过 Claude 等 AI Agent 生成虚假用户档案和公司信息。

设置 — 无需配置

只需安装 MCP 服务并与其对话。首次请求档案时，Agent 会提示你输入一次电子邮件地址，代你申请免费密钥，将其缓存在本地，并在之后的每次请求中使用。密钥也会通过电子邮件发送给你，作为凭证。

添加到 Claude Code MCP 配置（.mcp.json）中：

{
  "mcpServers": {
    "random-profiles": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "random-profiles-mcp"]
    }
  }
}

重启 Claude Code 并询问 “给我 5 个随机用户档案” — Agent 会自动完成密钥握手。无需浏览器，也无需复制粘贴。

密钥会缓存在 ~/.random-profiles/config.json（权限模式为 0600）中，因此每台机器只需操作一次。

想使用自己的密钥？

如果你已有 API 密钥（或想使用特定密钥）， 可通过环境变量设置并完全跳过申请流程：

{
  "mcpServers": {
    "random-profiles": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "random-profiles-mcp"],
      "env": {
        "RANDOM_PROFILES_API_KEY": "rp_your_key_here"
      }
    }
  }
}

环境变量的优先级高于缓存的密钥。

工具

工具	描述
claim_api_key	使用电子邮件地址申请免费 API 密钥（响应会返回密钥；Agent 也会通过电子邮件发送一份副本作为凭证）。仅在首次运行且未配置密钥时使用 — 之后会缓存密钥。
get_profiles	获取符合筛选条件的随机用户档案（数量、性别、国家/地区、年龄范围、字段）
get_profile	通过 UUID 获取单个档案
get_companies	获取符合筛选条件的随机虚假公司（数量、行业、国家/地区、规模、字段）
get_company	通过 UUID 获取单个公司
get_random_image	获取随机档案照片（JPEG，可选尺寸）
get_image	通过 UUID 获取指定档案照片（JPEG，可选尺寸）
get_usage	查看 API 密钥用量、套餐和每日限额（包含用于获得无限访问权限的买杯咖啡 support_url）

字段组

档案：name、email、phone、identity、bio、social、physical、job、address、financial、network、documents、vehicle、contact、digital、interests、education、photo、relationships、meta

公司：name、industry、size、location、contact、social、financial、tech、leadership、legal、operations、product、relationships、meta

relationships 组会返回跨资源 UUID：档案包含 company_uuid 和 colleague_uuids，公司包含 employee_uuids。可串联工具来补全关系图（例如：“给我 5 家公司，然后获取它们的员工”）。

图片格式

get_profiles 和 get_companies 都接受可选的 photo_format / logo_format 参数（jpg 或 webp）。在感知质量相当的情况下，WebP 比 JPG 小约 30%，且受到 96% 以上浏览器的支持。为确保最大兼容性，默认格式仍为 jpg。

示例

档案

“给我 5 个随机的美国档案”

“生成 10 个来自德国、年龄在 25 至 35 岁之间的女性档案”

“获取仅包含姓名和电子邮件字段的档案”

“给我看一张随机档案照片”

公司

“给我 5 家来自美国的虚构科技公司”

“生成 10 家员工人数为 51–200 人的医疗保健公司”

“获取 20 家仅包含名称、行业和领导层字段的公司”

“给我 3 家来自英国的金融公司，使用固定种子 42”

“给我 10 家带有 128px 标志的公司（用于图标网格）”

get_companies / get_company 的 logo_size 参数用于选择 meta.logo_url 中的尺寸变体 — 与档案中的 photo_size 用法相同。有效值：64、128、256、512、1024（默认值）。

环境变量

变量	必需	描述
RANDOM_PROFILES_API_KEY	是	你的 API 密钥（可在 random-profiles.com 获取）

另请参阅

• random-profiles-types — API 响应结构的 TypeScript 类型，适用于直接从 TypeScript 调用 API 的场景。
• random-profiles — 同一 API 的 CLI。

许可证

MIT