MCP Domain Availability

🚀 MCP域名可用性服務器

這是一個基於模型上下文協議（MCP）的服務器，藉助GoDaddy OTE（運營測試環境）API來檢查域名可用性和價格。

🚀 快速開始

本服務器藉助GoDaddy OTE API來檢查域名的可用性和價格，你可以按照以下步驟快速開始使用。

✨ 主要特性

• 通過GoDaddy OTE沙箱檢查域名可用性和價格。
• 支持多種頂級域名（TLD）後綴。
• 具備快速和全面兩種檢查模式。
• 支持批量域名檢查。
• 有速率限制（每分鐘60次調用）。
• 價格以美元為單位並保留兩位小數。
• 字段命名和數據結構保持一致。
• 週期進行歸一化處理（存儲為月，顯示為年）。

📦 安裝指南

使用uv（推薦）

# 安裝依賴
uv add "mcp[cli]"

# 使用MCP Inspector進行測試
DOMAIN_API_KEY="your-key:your-secret" mcp dev domain_availability/server.py

手動安裝

pip install -e .

📚 詳細文檔

配置

環境變量

• DOMAIN_API_KEY：你的GoDaddy OTE API憑證，格式為 "key:secret"（必需）

注意：服務器默認使用GoDaddy OTE（沙箱）API：https://api.ote-godaddy.com

GoDaddy OTE設置

1. 註冊GoDaddy開發者賬戶。
2. 獲取OTE（沙箱）API憑證。
3. 設置環境變量：DOMAIN_API_KEY="your-ote-key:your-ote-secret"

MCP配置

將以下內容添加到你的MCP客戶端配置中（例如Claude Desktop的 claude_desktop_config.json）：

{
  "mcpServers": {
    "domain-availability": {
      "command": "uv",
      "args": ["run", "mcp-domain-availability"],
      "env": {
        "DOMAIN_API_KEY": "your-ote-key:your-ote-secret"
      }
    }
  }
}

使用方法

開發與測試

# 啟動MCP Inspector進行測試
DOMAIN_API_KEY="your-key:your-secret" mcp dev domain_availability/server.py

這將在 http://localhost:6274 啟動MCP Inspector進行交互式測試。

可用工具

服務器提供一個工具：check_domain_availability

參數

選項1：直接指定域名列表

• domains：要檢查的域名數組（例如 ["example.com", "example.org"]）

選項2：指定基礎名稱和TLD後綴

• base_name：基礎域名（例如 "example"）
• tld_suffixes：TLD後綴數組（例如 [".com", ".org", ".net", ".io"]）

可選參數

• checkType："FAST" 或 "FULL"（默認："FAST"）
  • FAST：以速度為優化目標
  • FULL：以準確性為優化目標

示例

檢查特定域名

{
  "domains": ["example.com", "example.org", "example.net"],
  "checkType": "FAST"
}

檢查帶有多個TLD的基礎名稱

{
  "base_name": "myawesomesite",
  "tld_suffixes": [".com", ".org", ".net", ".io", ".dev", ".app"],
  "checkType": "FULL"
}

響應格式

文本響應：

域名可用性檢查結果：

✅ 可用域名：
  • example.com - 12.99美元/1年（確定）
  • example.org - 8.99美元/2年（初步）

❌ 不可用域名：
  • example.net - 不可用 - 域名已註冊

JSON響應（歸一化字段）：

{
  "domains": [
    {
      "domain_name": "example.com",
      "is_available": true,
      "price_dollars": 12.99,
      "currency_code": "USD",
      "is_definitive": true,
      "registration_period_months": 12
    },
    {
      "domain_name": "example.net",
      "is_available": false,
      "price_dollars": 0.00,
      "currency_code": "USD",
      "is_definitive": true,
      "registration_period_months": 12,
      "error_message": "Domain already registered"
    }
  ],
  "errors": []
}

數據歸一化

價格歸一化

• 輸入：GoDaddy API返回的價格以微單位（貨幣的1/1,000,000）表示。
• 輸出：轉換為美元並保留兩位小數。
• 示例：12000000 微單位 → $12.00 USD

週期歸一化

• 存儲：週期以月為單位存儲以保持一致性。
• 顯示：轉換為年以便用戶友好顯示。
• 示例：12個月 → "1年"，24個月 → "2年"

字段命名

採用一致、明確的字段名：

• domain_name（而非 domain）
• is_available（而非 available）
• price_dollars（而非 price）
• currency_code（而非 currency）
• is_definitive（而非 definitive）
• registration_period_months（而非 period）
• error_message（而非 error）

API集成

本服務器與GoDaddy OTE API集成：

• 基礎URL：https://api.ote-godaddy.com
• 端點：GET /v1/domains/available?domain={domain}
• 請求頭：Authorization: sso-key {key}:{secret}
• 速率限制：每分鐘60次請求

認證格式

Authorization: sso-key your-key:your-secret

錯誤處理

服務器處理各種錯誤情況：

• 缺少API密鑰
• 無效域名
• API速率限制（429） - 提供重試指導
• 部分響應（203）
• 認證錯誤（401、403）
• 服務器錯誤（500）
• 網絡超時

開發

設置開發環境

# 克隆並設置
git clone <repository>
cd mcp-free-domain
uv add "mcp[cli]"

# 運行測試
pytest

# 啟動開發服務器
DOMAIN_API_KEY="test-key:test-secret" mcp dev domain_availability/server.py

使用MCP Inspector進行測試

1. 設置你的OTE憑證：DOMAIN_API_KEY="your-key:your-secret"
2. 運行：mcp dev domain_availability/server.py
3. 在瀏覽器中打開 http://localhost:6274
4. 如果提示，請使用終端中顯示的會話令牌
5. 測試 check_domain_availability 工具

📄 許可證

本項目採用MIT許可證。

💻 支持

如有問題或疑問，請在倉庫中創建一個issue。