namegen

io.github.diegouqz由 GitHub 账号 diegouqz 发布v1.1.0更新于 Nov 1, 2026

Region-typical random names for AI agents. Remote MCP + HTTP API, paid in USDC via x402.

已验证Streamable HTTP可网页运行开发者工具数据与分析

概览

AI 生成的概览

远程 MCP 服务器,按地区生成随机的合成人名,并可列出支持的地区。

可以做什么
  • 按指定地区生成具有当地特色的人名,可设置数量、性别和随机种子
  • 列出支持的地区及其语言区域和姓名顺序
  • 返回结构化的姓名记录(名、姓、性别、地区、语言区域),并标注为合成数据
适用场景
适合需要为小说、游戏、原型图、测试数据或示例记录准备符合当地命名习惯(如双姓、姓在前)的虚构人名的场景。
运行要求
需要远程 streamable HTTP 端点;未声明账号、密钥或请求头。托管服务器通过 x402 按请求收取 USDC,生成姓名需要能签署 x402 付款的客户端;地区列表和发现文件免费。
安装前请注意
付费远程服务器每次生成姓名都会花费 USDC,并需要用钱包签署加密货币付款;无效请求在扣费前即被拒绝。姓名是随机组合,并非真实人物,不得用于冒充他人、创建虚假账号或通过身份验证。

安装

在 SourceWeft 中

  1. 打开 控制台中的 namegen,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.diegouqz%2Fnamegen/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "namegen": {
      "type": "http",
      "url": "https://namegen-diegouqz.fly.dev/mcp"
    }
  }
}

README

namegen

Generador de nombres aleatorios típicos de cada región, pensado para agentes de IA. Sin dependencias (Python ≥ 3.9, solo librería estándar).

Regiones: AR, BR, CN, DE, ES, FR, GB, IN, IT, JP, MX, NG, US (acepta alias como ARG, UK, USA).

Tres formas de acceso

InterfazComandoPara quién
HTTP APIpython -m namegen.server --port 8080 --base-url https://tu-dominio.comCualquier agente con acceso web
MCP (stdio)python -m namegen.mcp_serverClaude, Cursor y otros clientes MCP
CLIpython -m namegen.cli -r AR -n 5Scripts y agentes con shell

Descubrimiento para IAs

El servidor publica todo lo que un agente necesita para encontrarlo y usarlo sin intervención humana:

  • /llms.txt: guía en texto plano para LLMs
  • /openapi.json: OpenAPI 3.1 con operationId: generate_names (tool-calling directo)
  • /.well-known/agent.json: ficha de capacidades, interfaces, precio y política de uso
  • /.well-known/ai-plugin.json: manifiesto estilo plugin (compatibilidad)
  • Header Link en cada respuesta apuntando a OpenAPI y llms.txt
  • Errores JSON con code estable (REGION_UNSUPPORTED, COUNT_OUT_OF_RANGE…) y hint de cómo corregir

API

GET /v1/names?region=AR&count=3&gender=female&seed=abcGET /v1/regions
json
{  "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"}]}

Respeta convenciones locales: dos apellidos en MX/ES/BR, apellido primero en JP/CN.

Cobro en cripto (x402 + USDC)

Se activa definiendo la wallet que cobra:

bash
export NAMEGEN_PAY_TO=0xTuWalletexport NAMEGEN_PRICE_USDC=0.001        # por solicitudexport NAMEGEN_NETWORK=base-sepolia    # testnet; usar "base" en producciónpython -m namegen.server --base-url https://tu-dominio.com

Flujo: el agente llama → recibe 402 con qué pagar y a quién → firma el pago USDC con un cliente x402 → reintenta con el header X-PAYMENT → el servidor verifica y liquida con el facilitator y responde 200. Las solicitudes inválidas se rechazan con 400 antes de cobrar. /v1/regions y los archivos de descubrimiento son gratis.

Para mainnet (base) necesitás un facilitator que opere en mainnet (por ejemplo el de Coinbase CDP) en NAMEGEN_FACILITATOR_URL; el default x402.org/facilitator es para testnet.

Conectar al MCP

json
{"mcpServers": {"namegen": {"command": "python", "args": ["-m", "namegen.mcp_server"],                             "cwd": "/ruta/a/namegen"}}}

Política de uso

Los nombres son combinaciones aleatorias: no son personas ni identidades. Cada respuesta lleva "synthetic": true. Usos previstos: ficción, juegos, placeholders, mockups y datos de prueba. No usar para suplantar personas, crear cuentas bajo una persona inventada ni pasar verificaciones de identidad.

来源:README.md,提交 9e5cce4

工具

2

generate_names

Generate random personal names typical of a country/region (ISO 3166-1 alpha-2). Output is synthetic: for fiction, placeholders and test data. Not for impersonation or identity verification. On the paid remote server this returns the price and the exact URL to pay via x402 (USDC); pay= sets a pay-what-you-want amount above the minimum.

输入参数payseedcountgenderregion必填

list_regions

List supported regions with locale and name order.

无需输入参数。

版本历史

1
  1. v1.1.0最新Nov 1, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。