MCP Domain Availability

🚀 MCP域名可用性檢查器

MCP域名可用性檢查器是一個與模型上下文協議（MCP）集成的工具，它能為Claude Desktop提供跨流行頂級域名（TLD）的域名可用性檢查功能。

✨ 主要特性

• 域名可用性檢查
  • 可檢查50多種流行頂級域名（TLD）擴展的可用性。
  • 支持流行域名（如.com、.io、.ai）、國家域名（如.us、.uk、.de）和新的頂級域名（如.app、.dev、.tech）。
  • 採用DNS和WHOIS雙重驗證，確保結果準確。
  • 根據受歡迎程度智能推薦頂級域名。
• 搜索功能
  • 支持精確匹配頂級域名，檢查特定域名的可用性。
  • 可批量檢查給定名稱在支持的擴展下的可用性。
  • 並行處理，加快域名查詢速度。
  • 按頂級域名類別整理查詢結果。
• MCP集成
  • 通過uvx包管理工具輕鬆設置。
  • 與Claude Desktop無縫集成。
  • 即時更新域名可用性狀態。
  • 提供性能指標和時間信息。
• AI助手特性
  • 可通過Claude進行自然語言域名查詢。
  • 自動化域名推薦工作流程。
  • 根據可用性提供智能推薦。

🎥 演示

點擊下面的鏈接觀看演示視頻： 演示視頻

📦 安裝指南

依賴安裝

使用以下方法之一安裝uv包管理工具：

• 官方安裝程序（推薦）：

curl -LsSf https://astral.sh/uv/install.sh | sh

• Homebrew（適用於macOS/Linux）：

brew install uv

• 安裝Homebrew（如果需要）：
  • 訪問https://brew.sh獲取所有操作系統的安裝說明。
  • 或者運行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

MCP服務器會通過uvx自動管理Python依賴項。

零克隆安裝（推薦）

MCP域名可用性檢查器支持直接安裝，無需克隆倉庫，使用uvx進行包管理。

配置

Claude Desktop的配置文件位於：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

編輯此文件以添加域名可用性MCP配置：

{
  "mcpServers": {
    "mcp-domain-availability": {
      "command": "uvx",
      "args": [
        "--python=3.10",
        "--from",
        "git+https://github.com/imprvhub/mcp-domain-availability",
        "mcp-domain-availability"
      ]
    }
  }
}

如果您已經配置了其他MCP，只需在mcpServers對象中添加mcp-domain-availability部分：

{
  "mcpServers": {
    "otherMcp": {
      "command": "...",
      "args": ["..."]
    },
    "mcp-domain-availability": {
      "command": "uvx",
      "args": [
        "--python=3.10",
        "--from",
        "git+https://github.com/imprvhub/mcp-domain-availability",
        "mcp-domain-availability"
      ]
    }
  }
}

通過Smithery安裝

要通過Smithery自動為Claude Desktop安裝mcp-domain-availability，請運行：

npx -y @smithery/cli install @imprvhub/mcp-domain-availability --client claude

手動安裝

用於開發或本地測試：

1. 克隆倉庫：

git clone https://github.com/imprvhub/mcp-domain-availability
cd mcp-domain-availability

2. 安裝依賴項：

uv sync

3. 本地運行：

uv run src/mcp_domain_availability/main.py

🔧 技術細節

MCP域名可用性檢查器使用多種驗證方法來確定域名的可用性：

1. DNS解析：檢查域名是否解析為IP地址。
2. WHOIS查詢：查詢WHOIS數據庫以獲取註冊信息。
3. 套接字連接：當其他方法不可用時，回退到基於套接字的檢查。

該工具結合這些方法的結果，提供準確的可用性狀態，並通過並行處理同時檢查多個域名。

💻 使用示例

以下是如何使用MCP域名可用性檢查器與Claude的示例：

單個域名檢查

Check if mysite.com is available using --domain

域名名稱研究

Check availability for "startup" across all TLDs using --domain

特定域名驗證

Is awesome.io available? Use --domain to check

📚 詳細文檔

可用工具

支持的頂級域名類別

• 流行頂級域名（12個）：com、net、org、io、ai、app、dev、co、xyz、me、info、biz
• 國家頂級域名（35個）：us、uk、ca、au、de、fr、it、es、nl、jp、kr、cn、in、br、mx、ar、cl、co、pe、ru、pl、cz、ch、at、se、no、dk、fi、be、pt、gr、tr、za、eg、ma、ng、ke
• 新頂級域名：tech、online、site、website、store、shop、cloud、digital、blog、news等。

輸出格式

該工具提供全面的結果，包括：

• 請求的域名：查詢的精確域名的狀態（如果提供了特定的頂級域名）。
• 可用域名：可用域名列表，按字母順序排序。
• 不可用域名：已註冊域名列表。
• 統計摘要：按頂級域名類別（流行、國家、新頂級域名）分類統計。
• 性能指標：每個域名的檢查時長。

⚙️ 故障排除

“服務器斷開連接”錯誤

如果在Claude Desktop中看到連接錯誤：

1. 驗證uvx安裝：
   • 運行uvx --version以確保uvx已正確安裝。
   • 如有必要，重新安裝uv：curl -LsSf https://astral.sh/uv/install.sh | sh
2. 檢查Python版本：
   • 確保Python 3.10+可用：python3 --version

DNS解析問題

如果域名檢查失敗：

1. 網絡連接：
   • 驗證互聯網連接是否穩定。
   • 檢查DNS服務器是否可訪問。
2. 速率限制：
   • 大量批量檢查可能會觸發DNS/WHOIS服務的速率限制。
   • 該工具使用信號量將併發請求限制為20個。

配置問題

如果MCP服務器無法啟動：

1. 驗證配置語法：
   • 確保claude_desktop_config.json中的JSON語法有效。
   • 檢查所有括號和引號是否匹配。
2. 重啟Claude Desktop：
   • 更改配置後，關閉並重新啟動Claude Desktop。

🛠️ 開發

項目結構

• main.py：MCP服務器和域名檢查邏輯的主入口點。
• 包含使用DNS、WHOIS和套接字回退方法的域名檢查函數。
• 管理按類別分類的頂級域名列表。
• 支持並行域名檢查的異步處理。

構建

uv build

測試

uv run pytest

本地開發

uv run main.py

⚠️ 安全注意事項

MCP域名可用性檢查器會向DNS服務器和WHOIS服務發出外部網絡請求。用戶應注意：

• 域名查詢可能會被DNS提供商記錄。
• WHOIS查詢通常會被記錄，並且可能會受到速率限制。
• 除了被檢查的域名外，不會傳輸任何個人信息。
• 所有查詢均為只讀操作，不會修改任何外部系統。

🤝 貢獻

歡迎貢獻！可改進的方面包括：

• 添加對更多頂級域名類別的支持。
• 實現緩存機制，加快重複查詢速度。
• 增強WHOIS解析，獲取更詳細的域名信息。
• 改進錯誤處理和重試機制。

📄 許可證

本項目採用Mozilla公共許可證2.0 - 詳情請參閱LICENSE文件。

🔗 相關鏈接

• 模型上下文協議
• Claude Desktop
• uv包管理工具
• MCP系列