Name.ai MCP Server

Name: Name.ai MCP Server
Author: name.ai

远程服务

name.ai云与基础设施06 周前更新

代码仓库访问官网

关于 Name.ai MCP Server

Name.ai MCP Server 将 name.ai 的公开 API 封装为只读工具，供需要查询域名信息的用户使用。它支持域名可用性、WHOIS、TLD 注册价格和注册要求查询。

主要功能

01搜索域名并检查可用性
02查询 WHOIS 信息
03查看 TLD 注册价格
04查询 TLD 注册要求

适用场景

01检查候选域名是否可注册
02查询域名注册信息
03比较不同 TLD 的价格和要求

MCP 相关

该远程 MCP 服务通过 Streamable HTTP 暴露 name.ai 的公开 API 工具，MCP 客户端可连接 `/mcp` 端点。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.name.ai/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http ai-name-nameai https://mcp.name.ai/mcp

Cursor.cursor/mcp.json{"mcpServers":{"ai-name-nameai":{"type":"http","url":"https://mcp.name.ai/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"ai-name-nameai":{"type":"http","url":"https://mcp.name.ai/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"ai-name-nameai":{"type":"http","url":"https://mcp.name.ai/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"ai-name-nameai":{"serverUrl":"https://mcp.name.ai/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
domain	string	是
include_alternates	boolean	否

详细介绍

nameai-mcp

一个远程 MCP 服务，将 name.ai 的一些无需身份验证的公开 API 封装为工具：域名搜索与可用性查询、WHOIS 查询、顶级域名注册价格以及顶级域名要求。请参阅 src/nameai_mcp/server.py 中的工具定义，以及 src/nameai_mcp/nameai_client.py 中与 name.ai 通信的 HTTP 客户端。

端点

GET /health — 健康检查。
POST /mcp（以及用于 SSE 流的 GET /mcp）— MCP 可流式传输的 HTTP 端点。MCP 客户端/宿主通过此 URL 连接。

配置

NAMEAI_API_BASE_URL — 此服务调用的 name.ai API 基础 URL。默认为 https://name.ai。
HOST / PORT — 服务本身的绑定地址。默认为 0.0.0.0:8000。

本地开发

uv sync
uv run uvicorn nameai_mcp.app:app --reload

Docker

docker build -t nameai-mcp .
docker run -p 8000:8000 nameai-mcp

此镜像运行 nameai-mcp（src/nameai_mcp/__init__.py 中的 main() 入口点），该入口点会从环境中读取 HOST/PORT — 如果平台注入了不同的端口，请传入 -e PORT=...。

部署

任何能够运行 Docker 镜像的主机都可以。此服务通过 Coolify 部署在 Hetzner 服务器上，并通过 https://mcp.name.ai/mcp（可流式传输的 HTTP）提供服务，由 Traefik 终止 TLS。原主机名 https://nameai-mcp.h.namekart.com/mcp 仍然路由到同一个容器，因此基于它编写的客户端配置仍可正常工作。

mcp.name.ai 是指向 Hetzner 主机的仅 DNS A 记录。设置它的原因是，扫描器和 MCP 工具会寻找 mcp.<domain> 上的服务，而不会从清单中读取 URL — 在此容器自己的访问日志中观察到，ora 的扫描器在扫描期间从未访问清单中的 mcpUrl。添加主机名除了 DNS 外，还需要设置两项内容：在 Coolify 应用中添加域名，以及将该主机追加到 MCP_ALLOWED_HOSTS；否则 SDK 的 DNS 重绑定防护会以 421 响应。

此服务会调用 NAMEAI_API_BASE_URL 指定的公开 API，默认值为 https://name.ai。由于 name.ai 已迁移到 Hetzner，该地址会解析到此容器所在的同一台主机，因此调用会离开容器，访问主机自身的公网 IP，再经由 Traefik 返回。此处的这种回环方式可行，并且是有意保留的：按外部客户端的方式与 API 通信，正是此服务的目的。

能够访问不等于能够被发现 — 而这部分已经完成。name.ai 在以下四处公布了此服务：