Domain Search MCP

🚀 Domain Search MCP

Domain Search MCP 為 MCP 客戶端提供快速、以本地優先的域名可用性檢查。它可以零配置使用公共 RDAP/WHOIS 進行查詢，還可以通過你控制的後端獲取註冊商定價信息來豐富查詢結果。

最新特性

• v1.9.0+：現在開箱即用 AI 驅動的域名建議功能！無需 API 密鑰 - suggest_domains_smart 使用我們公開的微調 Qwen 7B - DPO 模型。
• 新增 Redis 分佈式緩存、斷路器和 /metrics 端點以實現可觀測性。

本項目基於 Model Context Protocol 構建，適用於 Claude、Codex、VS Code、Cursor、Cline 等 MCP 兼容客戶端。

🚀 快速開始

選項 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

✨ 主要特性

• 多 TLD 單域名檢查：可檢查單個名稱在多個頂級域名（TLD）中的可用性。
• 單 TLD 批量檢查：可批量檢查多達 100 個名稱在單個 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

💻 使用示例

基礎用法

# 無需 API 密鑰的示例
search_domain("myproject", ["com", "io"])

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

高級用法

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

📚 詳細文檔

傳輸選項

stdio（默認）

適用於 Claude Desktop、Cursor、VS Code 等 MCP 客戶端，使用標準輸入/輸出：

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 用於消息，GET 用於 SSE 流）
• /api/tools/* - 每個工具的 REST API（與 ChatGPT Actions 兼容）
• /openapi.json - OpenAPI 3.1 規範
• /health - 健康檢查
• /metrics - 兼容 Prometheus 的指標（緩存統計、請求計數、AI 推理健康狀況）

ChatGPT 自定義 GPT 集成

1. 啟動 HTTP 服務器（見上文）
2. 通過 ngrok 暴露服務：ngrok http 3000
3. 在 ChatGPT 中創建自定義 GPT 並添加操作
4. 從 https://your-ngrok-url.ngrok-free.dev/openapi.json 導入 OpenAPI 規範
5. 測試工具！

工具列表

核心搜索工具

• search_domain：檢查單個名稱在多個 TLD 中的可用性，並添加高級/拍賣信號。
• bulk_search：檢查多達 100 個名稱在單個 TLD 中的可用性。
• compare_registrars：（配置後端時可用）比較不同註冊商的定價。

AI 驅動的建議工具

• suggest_domains：生成域名變體（前綴/後綴/連字符）。
• suggest_domains_smart：🤖 AI 驅動 使用微調 Qwen 7B - DPO 生成品牌化名稱。零配置 - 立即生效！
• analyze_project：掃描本地項目或 GitHub 倉庫以提取上下文並建議匹配的域名。

域名投資工具

• hunt_domains：查找有投資價值的域名 - 掃描 Sedo 拍賣、生成模式、計算投資分數。
• expiring_domains：監控即將到期的域名（需要聯合負緩存）。

實用工具

• tld_info：TLD 元數據和限制信息。
• check_socials：檢查用戶名在多個平臺上的可用性。
• ai_health：檢查 AI 推理服務的狀態（VPS Qwen、斷路器、自適應併發）。

配置說明

定價後端（推薦）

設置擁有註冊商密鑰（Porkbun）的後端 URL。MCP 將調用該後端的 /api/quote 和 /api/compare 進行定價查詢。

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

可選的自帶密鑰（本地）

僅在未設置 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) 開箱即用，使用我們公開的運行微調 Qwen 7B - DPO 的 VPS。無需 API 密鑰！ 對於自託管設置，覆蓋端點：

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

環境變量

輸出格式

工具響應默認以 Markdown 表格 形式返回。如果你需要用於編程的原始 JSON 數據，請設置：

OUTPUT_FORMAT=json

數據來源

定價行為

• 對於每個 可用 域名，首先嚐試獲取即時價格。
• 如果即時報價失敗或受到速率限制，結果將回退到目錄估計值，幷包含 price_note。
• 在購買前，始終通過 price_check_url 驗證定價。

🔧 技術細節

工作原理

可用性和定價查詢有意分開處理：

• 可用性（默認）：
  • 主要：RDAP
  • 備用：WHOIS
  • GoDaddy 公共端點僅用於在 search_domain 中添加高級/拍賣信號
• 定價（可選）：
  • 推薦：PRICING_API_BASE_URL（帶有 Porkbun 密鑰的後端）
  • 可選自帶密鑰：僅在未配置後端時支持 Porkbun/Namecheap

這樣可以保持服務器零配置，同時允許高級用戶啟用定價功能。

定價驗證

響應中包含 price_check_url（註冊商結賬/搜索鏈接），當價格為估計值時可能包含 price_note。在購買前，始終在註冊商結賬頁面驗證最終價格。

如果檢測到拍賣/高級信號，結果將包含 aftermarket 塊，其中包含可用的市場頁面鏈接。已佔用的域名可能包含 Sedo 拍賣提示（公共源）和基於名稱服務器的市場提示（Sedo/Dan/Afternic）。

📄 許可證

本項目許可證信息請查看 。

開發與發佈

開發

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（或自帶密鑰）時，無法獲取定價信息（可用性檢查仍可正常工作）。

升級指南

npx 用戶

如果你使用 npx domain-search-mcp（未使用 @latest），npx 可能會緩存舊版本。 解決方法：更新 MCP 配置以使用 @latest：

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

或者手動清除 npx 緩存：

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 與 HTTP/SSE）
• 工具執行流程
• 數據源瀑布式查詢（RDAP → 定價 API → WHOIS）
• VPS 部署架構
• AI 建議流程
• MCP 會話生命週期

相關鏈接

• MCP 註冊表：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