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系列