MCP 服务器

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

最后更新：2026 年 9 月 4 日

它是什么

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

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

安装配置

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

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

{
  "mcpServers": {
    "namescope": {
      "command": "node",
      "args": ["/path/to/namescope/apps/mcp/dist/main.js"],
      "env": {
        "NAMESCOPE_API_KEY": "ns_live_...",
        "NAMESCOPE_API_URL": "https://api.namescope.dev"
      }
    }
  }
}

Claude Code —— 一条命令即可：

claude mcp add namescope \
  --env NAMESCOPE_API_KEY=ns_live_... \
  --env NAMESCOPE_API_URL=https://api.namescope.dev \
  -- node ./apps/mcp/dist/main.js

工具

工具	功能	费用
namescope_scan_name	跨商标、域名、社交媒体、开发者平台和应用商店查询一个名称	最多 100 积分，按模块计
namescope_get_scan	按 id 读取扫描，可选择等待其完成	免费
namescope_list_scans	列出工作区最近的扫描	免费
namescope_usage	套餐、积分余额、限额以及密钥的作用域	免费
namescope_reference	尼斯分类、商标局、TLD 层级或适配器列表	免费

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

等待结果

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

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

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

发起一次查询

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

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

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

出错时

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

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