Name.ai MCP Server

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 のストリーミング 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 イメージを実行できるホストであれば、どこでも動作します。Hetzner サーバー上で Coolify を通じてデプロイされ、Traefik で TLS を終端して https://mcp.name.ai/mcp（ストリーミング HTTP）で提供されています。元のホスト名である https://nameai-mcp.h.namekart.com/mcp も引き続き同じコンテナにルーティングされるため、この URL を使って作成されたクライアント設定も引き続き機能します。

mcp.name.ai は Hetzner のマシンを指す DNS 専用の A レコードです。これは、スキャナーや MCP ツールがマニフェストから URL を読み取るのではなく、mcp.<domain> にあるサーバーを探すためです。このコンテナ自身のアクセスログを見ると、ora のスキャナーはスキャン中にマニフェストの mcpUrl に接続していませんでした。ホスト名を追加するには、DNS 以外に次の 2 つが必要です。Coolify アプリにドメインを追加することと、MCP_ALLOWED_HOSTS にホストを追加することです。後者がないと、SDK の DNS リバインディングガードが 421 を返します。

サーバーは NAMEAI_API_BASE_URL（デフォルトは https://name.ai）にある公開 API を呼び出します。name.ai は Hetzner に移転したため、この URL はコンテナが稼働するホストと同じ宛先に解決されます。そのため、呼び出しはコンテナから出てホスト自身のパブリック IP に到達し、Traefik を経由して戻ってきます。このヘアピン接続はここでは機能しており、意図的にそのままにしています。外部クライアントとまったく同じ方法で API と通信することが、このサーバーの目的だからです。

接続可能であることと、見つけてもらえることは別ですが、後者への対応も済んでいます。name.ai は次の 4 か所でこのサーバーを案内しています。

• https://name.ai/.well-known/mcp.json — マニフェスト
• https://name.ai/.well-known/mcp/server-card.json — サーバーカード
• https://name.ai/llms.txt — エンドポイント一覧とツールのガイダンスの両方
• MCP Registry、名前空間 ai.name、ドメイン認証済み

これら 4 つはすべて nameaiv1 リポジトリにあります。デプロイ先の URL が変われば、それに合わせて更新されます。そうしないと、エージェントが古い URL を参照し続けます。