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。