Domain Search MCP

🚀 Domain Search MCP

Fast, local-first domain availability checks for MCP clients. Works with zero configuration using public RDAP/WHOIS, and optionally enriches results with registrar pricing via a backend you control.

🆕 v1.9.0+: AI-powered domain suggestions now work out of the box! No API keys needed - suggest_domains_smart uses our public fine-tuned Qwen 7B-DPO model. Plus: Redis distributed caching, circuit breakers, and /metrics endpoint for observability.

Built on the Model Context Protocol for Claude, Codex, VS Code, Cursor, Cline, and other MCP-compatible clients.

✨ 主な機能

• 単一のドメイン名について、複数のTLDで利用可能性をチェックします。
• 最大100のドメイン名について、1つのTLDで一括チェックします。
• レジストラの価格を比較します（バックエンドが設定されている場合）。
• ドメイン名を提案し、ソーシャルハンドルを検証します。
• search_domainでプレミアム/オークションのシグナルを検出します。

📦 インストール

オプション1: npx（推奨）

インストール不要で直接実行できます。

npx -y domain-search-mcp@latest

オプション2: ソースから

git clone https://github.com/dorukardahan/domain-search-mcp.git
cd domain-search-mcp
npm install
npm run build
npm start

💻 使用例

基本的な使用法

stdio（デフォルト）

Claude Desktop、Cursor、VS CodeなどのMCPクライアントでは、stdin/stdoutを使用します。

npx -y domain-search-mcp@latest

HTTP/SSE（ChatGPT、Webクライアント、LM Studio）

ChatGPT Actions、Webアプリ、REST APIクライアントでは、以下のコマンドを使用します。

# ポート3000でHTTPサーバを起動
npx -y domain-search-mcp@latest --http

# またはカスタムポートを使用
MCP_PORT=8080 npx -y domain-search-mcp@latest --http

エンドポイント:

• /mcp - MCPプロトコル（メッセージのPOST、SSEストリームのGET）
• /api/tools/* - 各ツールのREST API（ChatGPT Actions互換）
• /openapi.json - OpenAPI 3.1仕様
• /health - ヘルスチェック
• /metrics - Prometheus互換のメトリクス（キャッシュ統計、リクエスト数、AI推論の健全性）

ChatGPT Custom GPT統合

1. HTTPサーバを起動します（上記を参照）。
2. ngrokを使用して公開します: ngrok http 3000。
3. ChatGPTでCustom GPTを作成し、アクションを追加します。
4. https://your-ngrok-url.ngrok-free.dev/openapi.jsonからOpenAPI仕様をインポートします。
5. ツールをテストします！

高度な使用法

コマンドラインオプションの使用

# カスタムポートでHTTPサーバを起動
MCP_PORT=8080 npx -y domain-search-mcp@latest --http

REST APIの使用

curl -X POST https://your-domain/api/tools/search_domain \
  -H "Content-Type: application/json" \
  -d '{"domain_name":"vibecoding"}'

📚 ドキュメント

設定

価格バックエンド（推奨）

レジストラのキー（Porkbun）を持つバックエンドのURLを設定します。MCPはそのバックエンドの/api/quoteと/api/compareを呼び出して価格を取得します。

PRICING_API_BASE_URL=https://your-backend.example.com
PRICING_API_TOKEN=optional_bearer_token

オプションのBYOK（ローカル）

PRICING_API_BASE_URLが設定されていない場合のみ使用されます。

• Porkbunキー:
  • https://porkbun.com/account/api
  • https://porkbun.com/api/json/v3/documentation
• Namecheapキー（IPホワイトリストが必要）:
  • https://ap.www.namecheap.com/settings/tools/apiaccess/
  • https://www.namecheap.com/support/api/intro/

PORKBUN_API_KEY=pk1_your_api_key
PORKBUN_API_SECRET=sk1_your_secret
NAMECHEAP_API_KEY=your_api_key
NAMECHEAP_API_USER=your_username
NAMECHEAP_CLIENT_IP=your_whitelisted_ip

Redis分散キャッシュ（オプション）

複数のMCPインスタンス間で水平スケーリングする場合は、Redisを設定します。

REDIS_URL=redis://:password@host:6379

Redisを使用しない場合、サーバはメモリ内キャッシュを使用します（単一インスタンスでは問題ありません）。Redisを使用すると、以下の機能が有効になります。

• 複数のサーバインスタンス間で共有キャッシュを使用できます。
• 再起動後もキャッシュが保持されます。
• ロードバランスされたデプロイメントでキャッシュヒット率が向上します。

AI推論（ゼロコンフィグ）

AIによるドメイン提案（suggest_domains_smart）は、公開されているVPS上で微調整されたQwen 7B-DPOモデルを使用して、ゼロコンフィグで動作します。APIキーは必要ありません！

セルフホスト環境では、エンドポイントをオーバーライドできます。

QWEN_INFERENCE_ENDPOINT=http://your-server:8000
QWEN_API_KEY=optional_if_secured

環境変数

出力フォーマット

ツールのレスポンスはデフォルトでMarkdownテーブルとして返されます。プログラムで使用するために生のJSONが必要な場合は、以下のように設定します。

OUTPUT_FORMAT=json

データソース

価格の検証

レスポンスにはprice_check_url（レジストラのチェックアウト/検索リンク）が含まれ、価格が推定される場合はprice_noteが含まれる場合があります。購入前に常にレジストラのチェックアウトページで最終価格を確認してください。

オークション/プレミアムシグナルが検出された場合、結果にはaftermarketブロックが含まれ、利用可能な場合はマーケットプレイスページへのリンクが含まれます。取得済みのドメインには、Sedoオークションのヒント（公開フィード）とネームサーバーベースのマーケットプレイスヒント（Sedo/Dan/Afternic）が含まれる場合があります。

価格の振る舞い

• すべての利用可能なドメインについて、まずライブ価格が試行されます。
• ライブ見積もりが失敗した場合、またはレート制限された場合、結果はカタログの推定値にフォールバックされ、price_noteが含まれます。
• 購入前に常にprice_check_urlを使用して価格を確認してください。

例（APIキーなし）

search_domain("myproject", ["com", "io"])

myproject.com - available - price_first_year: null - source: rdap
myproject.io  - taken     - price_first_year: null - source: rdap

開発

npm run dev       # ウォッチモード
npm test          # Jestを実行
npm run build     # dist/にコンパイル

リリース

キャナリー → 最新版の公開フローについては、docs/RELEASE.mdを参照してください。v1.2.24のようなタグが付けられると、CIを通じてGitHub Releasesとnpm公開がトリガーされます。

変更履歴

リリース履歴については、CHANGELOG.mdを参照してください。

セキュリティに関する注意事項

• APIキーや.mcpregistry_*ファイルをコミットしないでください。
• PRICING_API_BASE_URL（またはBYOKキー）が設定されていない場合も、利用可能性のチェックは機能しますが、価格情報は利用できません。

アップグレード

npxユーザーの場合

npx domain-search-mcp（@latestなし）を使用している場合、npxが古いバージョンをキャッシュする可能性があります。 解決策: MCP設定を更新して@latestを使用するか、手動でnpxキャッシュをクリアします。

"args": ["-y", "domain-search-mcp@latest"]

npx clear-npx-cache  # その後、MCPクライアントを再起動

ソース/Gitユーザーの場合

cd domain-search-mcp
git pull origin main
npm install
npm run build

最新の状態を維持する

• リポジトリをウォッチする: GitHubで「Watch」→「Releases only」をクリックして、新しいバージョンの通知を受け取ります。
• リリースを確認する: GitHub Releasesで変更履歴とアップグレードノートを確認します。
• npmページ: npmjs.com/package/domain-search-mcpで最新バージョンを確認します。

アーキテクチャ

詳細なシステムアーキテクチャ図については、docs/ARCHITECTURE.mdを参照してください。

• トランスポート層（stdio vs HTTP/SSE）
• ツールの実行フロー
• データソースのウォーターフォール（RDAP → 価格API → WHOIS）
• VPSデプロイメントアーキテクチャ
• AI提案のフロー
• MCPセッションのライフサイクル

リンク

• MCP Registry: https://registry.modelcontextprotocol.io
• Glamaページ: https://glama.ai/mcp/servers/@dorukardahan/domain-search-mcp
• Context7インデックス: https://context7.com/dorukardahan/domain-search-mcp
• アーキテクチャ: docs/ARCHITECTURE.md
• APIリファレンス: docs/API.md
• 設定: docs/CONFIGURATION.md
• ワークフロー: docs/WORKFLOWS.md