关于 namegen
namegen 为 AI Agent 和其他应用生成符合所选地区习惯的合成随机姓名，提供 HTTP API、MCP 和命令行接口，并遵循本地姓名规则；还可通过 x402 收取 USDC。
主要功能
- 01生成 13 个地区的姓名
- 02接受地区别名
- 03设置数量、性别和随机种子
- 04遵循本地姓名顺序规则
- 05提供 HTTP API、MCP 和命令行
适用场景
- 01为游戏创建虚构姓名
- 02在原型图中填入占位姓名
- 03生成测试数据
- 04为 AI Agent 提供合成姓名
MCP 相关
namegen 为 MCP 客户端提供 stdio MCP 服务，同时提供 HTTP API 和命令行接口。姓名生成能力可接收地区及数量、性别和随机种子等选项。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://namegen-diegouqz.fly.dev/mcpclaude mcp add --transport http diegouqz-namegen https://namegen-diegouqz.fly.dev/mcp{"mcpServers":{"diegouqz-namegen":{"type":"http","url":"https://namegen-diegouqz.fly.dev/mcp"}}}在 Cursor 中打开{"servers":{"diegouqz-namegen":{"type":"http","url":"https://namegen-diegouqz.fly.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"diegouqz-namegen":{"type":"http","url":"https://namegen-diegouqz.fly.dev/mcp"}}}{"mcpServers":{"diegouqz-namegen":{"serverUrl":"https://namegen-diegouqz.fly.dev/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
namegen
为 AI Agent 生成各地区典型的随机姓名。 无需依赖（Python ≥ 3.9，仅使用标准库）。
地区： AR、BR、CN、DE、ES、FR、GB、IN、IT、JP、MX、NG、US（接受 ARG、UK、USA 等别名）。
三种访问方式
| 接口 | 命令 | 适用对象 |
|---|---|---|
| HTTP API | python -m namegen.server --port 8080 --base-url https://tu-dominio.com | 任何可访问 Web 的 Agent |
| MCP（stdio） | python -m namegen.mcp_server | Claude、Cursor 和其他 MCP 客户端 |
| CLI | python -m namegen.cli -r AR -n 5 | 脚本和可使用 shell 的 Agent |
供 AI 发现
服务会发布 Agent 无需人工介入即可发现并使用它所需的所有信息：
/llms.txt：面向 LLM 的纯文本指南/openapi.json：包含operationId: generate_names的 OpenAPI 3.1 规范（可直接进行工具调用）/.well-known/agent.json：能力、接口、价格和使用政策说明/.well-known/ai-plugin.json：插件风格的清单（兼容性支持）- 每个响应中的
Link标头，指向 OpenAPI 和 llms.txt - JSON 错误包含稳定的
code（REGION_UNSUPPORTED、COUNT_OUT_OF_RANGE等）以及说明如何修正的hint
API
GET /v1/names?region=AR&count=3&gender=female&seed=abc
GET /v1/regions
{
"schema": "namegen.v1", "region": "AR", "count": 1, "seed": null, "synthetic": true,
"results": [{"id": "…", "full_name": "Martina Acosta", "given_name": "Martina",
"family_names": ["Acosta"], "gender": "female", "region": "AR", "locale": "es-AR"}]
}
遵循当地惯例：MX/ES/BR 使用两个姓氏，JP/CN 姓氏在前。
加密货币收费（x402 + USDC）
设置收款钱包即可启用：
export NAMEGEN_PAY_TO=0xTuWallet
export NAMEGEN_PRICE_USDC=0.001 # por solicitud
export NAMEGEN_NETWORK=base-sepolia # testnet; usar "base" en producción
python -m namegen.server --base-url https://tu-dominio.com
流程：Agent 发起调用 → 收到 402，其中说明付款金额和收款方 → 使用 x402 客户端签署 USDC 付款
→ 使用 X-PAYMENT 标头重试 → 服务验证并通过 facilitator 结算，然后返回 200。
无效请求会在收费前被拒绝并返回 400。/v1/regions 和发现文件均免费。
对于主网（base），你需要在 NAMEGEN_FACILITATOR_URL 中配置支持主网运行的 facilitator（例如 Coinbase CDP 的 facilitator）；默认的 x402.org/facilitator 用于测试网。
连接到 MCP
{"mcpServers": {"namegen": {"command": "python", "args": ["-m", "namegen.mcp_server"],
"cwd": "/ruta/a/namegen"}}}
使用政策
这些姓名是随机组合，并不代表真实人物或身份。每个响应都会附带
"synthetic": true。预期用途：虚构作品、游戏、占位符、模型图和测试数据。
不得用于冒充他人、以虚构身份创建账户或通过身份验证。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。