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 分

    請在儲存庫或註冊中心條目中宣告授權條款。