MCP 服务器

让 Claude 或任何其他 MCP 客户端替你查询名称。该服务器在你自己的机器上运行，使用你的密钥与 Namesight API 通信，并对外提供五个工具。

最后更新：2026 年 9 月 6 日

它是什么

Model Context Protocol 是 AI 助手访问自身之外工具的方式。Namesight MCP 服务器就是一个会说这种协议的小程序：助手发出名称查询请求，服务器调用与你自己会调用的同一套公开 API，然后把结果交回。

它自身不保存任何数据。作用域、积分和速率限制完全由 API 按直接请求的方式强制执行，因此该服务器做不到任何你的密钥做不到的事。

安装配置

你需要一个具备 scans:read、scans:write 和 reference:read 作用域的 API 密钥。请在「设置 → API 密钥」中创建。

Claude Desktop —— 将服务器添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "namesight": {
      "command": "node",
      "args": ["/path/to/namesight/apps/mcp/dist/main.js"],
      "env": {
        "NAMESIGHT_API_KEY": "ns_live_...",
        "NAMESIGHT_API_URL": "https://api.namesight.app"
      }
    }
  }
}

Claude Code —— 一条命令即可：

claude mcp add namesight \
  --env NAMESIGHT_API_KEY=ns_live_... \
  --env NAMESIGHT_API_URL=https://api.namesight.app \
  -- node ./apps/mcp/dist/main.js

工具

工具	功能	费用
namesight_scan_name	跨商标、域名、社交媒体、开发者平台和应用商店查询一个名称	最多 100 积分，按模块计
namesight_get_scan	按 id 读取扫描，可选择等待其完成	免费
namesight_list_scans	列出工作区最近的扫描	免费
namesight_usage	套餐、积分余额、限额以及密钥的作用域	免费
namesight_reference	尼斯分类、商标局、TLD 层级或适配器列表	免费
namesight_rescan	以相同设置重新运行检测	按检测计费
namesight_retry_unknowns	仅重试未能验证的检查	免费
namesight_delete_scan	删除检测；标记为破坏性操作，客户端会先确认	免费
namesight_share_report	为报告创建公开链接（reports:write）	免费
namesight_list_projects	列出工作区的项目（projects:read）	免费
namesight_generate_names	根据简介、种子或主题提出名称创意（ideas:write）	免费

只有 namesight_scan_name 会产生消费，而它也是唯一被标记为写操作的工具，因此会在写操作前询问的客户端也会在扫描前先行询问。

资源与提示词

参考列表也作为资源提供——namesight://reference/nice-classes、regions、tlds 和 adapters——客户端可一次性附加到对话中，而不必每次消耗一次工具调用。check_brand_name 提示词是现成的任务书：检测名称、重试未验证项、解释结果，若名称已被占用则提出替代方案。

每个工具都声明输出模式，list_scans 通过 cursor 与 status 分页。连接中断后重试是安全的：服务器会重放第一次响应，而不会重复扣费。

等待结果

扫描需要时间，而一次工具调用只返回一次。默认情况下，namesight_scan_name 会立即返回 scanId，助手再用 namesight_get_scan 读取结果。

传入 waitMs 可让服务器代为等待：它会轮询直到扫描结束，起初约每秒一次，随后逐步拉长到五秒，然后把结果直接返回。如果时间预算耗尽，你得到的是部分完成的扫描而不是错误 —— 那些已完成的检查依然值得一读。

变量	默认值	含义
NAMESIGHT_API_KEY	—	必填。你的 API 密钥
NAMESIGHT_API_URL	http://localhost:4000	API 根地址
NAMESIGHT_MCP_MAX_WAIT_MS	120000	waitMs 的上限
NAMESIGHT_MCP_TIMEOUT_MS	30000	单次 HTTP 请求的超时时间

发起一次查询

服务器连接好之后，你只需用自然语言提问，助手会自行选择工具。一个有用的请求会写明类别或目标市场，因为正是这些信息把真正的冲突和无关商标区分开来。

查一下 "Lumina Labs" 这个名字能否用于一家游戏工作室，
市场为土耳其和欧盟 —— 尼斯分类第 9 类和第 41 类。

助手通常会先用 namesight_reference 查出类别，然后发起扫描、等待完成，并总结哪些因素会阻碍这个名称、哪些不会。

出错时

API 故障会以可读的工具错误形式返回，而不是直接崩溃，这样助手就能解释问题所在，并在力所能及时修正并重试。

401 —— 密钥缺失、无效、已吊销或已过期
402 —— 工作区套餐不包含 API
403 —— 密钥缺少作用域，或积分消费已关闭
429 —— 超出速率限制或积分余额