nameai-mcp

一个远程 MCP 服务器，将 name.ai 的几个公开、无需认证的 API 暴露为工具：域名搜索/可用性、WHOIS 查询、TLD 注册定价和 TLD 要求。工具定义参见 src/nameai_mcp/server.py；与 name.ai 通信的 HTTP 客户端参见 src/nameai_mcp/nameai_client.py。

端点

• GET /health — 健康检查。

• POST /mcp（以及用于 SSE 流的 GET /mcp）— MCP 的 streamable-http 端点。这是 MCP 客户端/主机所连接的 URL。

Related MCP server: FastDomainCheck MCP Server

配置

• 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 镜像的主机都可以。要让它以 https://mcp.name.ai 的形式可供 AI 智能体访问，name.ai 的 DNS 托管在 Cloudflare 上——为 mcp 子域添加一条指向该容器运行位置的 A/CNAME 记录，并在那里终止 TLS（例如，若与 nameaiv1 的其他部分一同托管，则通过 Coolify/Traefik 实现）。

可被访问并不等于被发现——目前 name.ai 上没有任何内容指向这个服务器。要让某个智能体（或像 ora 这样的扫描器）找到它，name.ai 本身需要提供指向它的入口，例如 /llms.txt 中的一行或一个 .well-known/mcp.json 清单。那是 nameaiv1 仓库中的改动，而非本仓库的改动。