nameai-mcp

name.ai의 공개 API 중 인증이 필요 없는 것 몇 가지를 도구로 노출하는 원격 MCP 서버입니다: 도메인 검색/가용성, 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 이미지를 실행할 수 있는 호스트라면 어디서든 작동합니다. AI 에이전트가 https://mcp.name.ai로 접근할 수 있게 하려면, name.ai의 DNS가 Cloudflare에 있으므로 — mcp 하위 도메인에 대한 A/CNAME 레코드를 이 컨테이너가 실행되는 곳을 가리키도록 추가하고, 그곳에서 TLS를 종료하세요(예: nameaiv1의 나머지와 함께 호스팅되는 경우 Coolify/Traefik을 통해).

접근 가능한 것과 발견되는 것은 같지 않습니다 — 현재 name.ai에는 이 서버를 가리키는 항목이 없습니다. 에이전트(또는 ora 같은 스캐너)가 이 서버를 찾으려면, name.ai 자체에 이 서버를 가리키는 포인터가 있어야 합니다. 예: /llms.txt의 한 줄 또는 .well-known/mcp.json 매니페스트. 그것은 이 저장소가 아니라 nameaiv1 저장소의 변경 사항입니다.