SuperAPI AI 工具集

mcp-domain-availability

mcp-domain-availability 是一个 Model Context Protocol(MCP)服务器,使 Claude Desktop 能够跨 50 多个顶级域(TLD)检查域名可用性。它提供 DNS/WHOIS 验证、批量检查与智能建议,并支持通过 uvx 零克隆安装。该工具以 RDAP 作为权威验证协议,在部分 TLD 没有 RDAP 服务时回退至 WHOIS 和 DNS。查询结果分为可用、不可用或无法确定三种状态,并附有性能指标与来源说明。适合在 AI 助手中以自然语言快速查询和筛选域名。

访问官网

工具介绍

mcp-domain-availability 是一个 Model Context Protocol(MCP)服务器,主要用途是让 Claude Desktop 能够检查域名可用性,覆盖 50 多个流行顶级域(TLD)。用户可通过自然语言向 Claude 提问,由该服务器执行域名查询并返回结果。

主要能力:

  • 域名可用性检查:支持流行 TLD(如 .com、.io、.ai)、国家 TLD(如 .us、.uk、.de)以及新 TLD(如 .app、.dev、.tech)。
  • 权威验证:优先使用 RDAP(取代 WHOIS 的协议),对没有 RDAP 服务的少数 TLD 回退至 WHOIS 和 DNS。
  • 智能建议:按流行度组织 TLD 建议。
  • 搜索能力:精确 TLD 匹配检查特定域名;对给定名称在所有支持的扩展名中进行批量检查;并行处理加快查询;按 TLD 类别组织结果。
  • 集成特性:通过 uvx 包管理轻松安装,与 Claude Desktop 无缝集成,提供实时可用性状态更新,以及性能指标和计时信息。
  • AI 助手功能:通过 Claude 进行自然语言域名查询、自动化域名建议工作流、基于可用性的智能推荐。

使用方式:

  • 环境要求:Python 3.10 或更高版本(推荐 3.12),uv 包管理器。
  • 安装 uv 包管理器:官方安装器(推荐)、Homebrew(macOS/Linux),或运行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
  • MCP 服务器通过 uvx 自动管理 Python 依赖。
  • 支持无需克隆仓库的直接安装,使用 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-domain-availability 配置。
  • 可通过 Smithery 自动安装。
  • 开发或本地测试:克隆仓库、安装依赖。
  • 使用 Docker 部署到 Google Cloud Run:服务器支持两种传输模式,stdio(默认,用于 Claude Desktop 集成)和 sse(用于 HTTP/Web 部署,如 Google Cloud Run)。部署到 Cloud Run 时,必须将 MCP_TRANSPORT 环境变量设置为 sse。需要 Google Cloud SDK 已安装并认证、Docker 已安装并运行,以及启用 Cloud Run 和 Container Registry API 的 Google Cloud 项目。可使用 deploy.sh 脚本或手动运行命令。本地 Claude Desktop 使用无需环境变量。
  • 可用工具:0.5.0 起 --domain 标志不再必需,可用自然语言询问域名,该标志仍被接受以兼容现有提示。批量 TLD 检查已移至独立工具。

支持的 TLD 类别包括:流行类(com、net、org、io、ai、app、dev、co、xyz、me、info、biz)、国家类(us、uk、ca、au、de、fr、it、es、nl、jp、kr、cn、in、br、mx、ar、cl、pe、ru、pl、cz、ch、at、se、no、dk、fi、be、pt、gr、tr、za、eg、ma、ng、ke)、新 TLD 类(tech、online、site、website、store、shop、cloud、digital、blog、news 等)。

验证机制:ICANN 于 2025 年 1 月弃用 WHOIS 作为必需的注册数据协议,改用 RDAP(RFC 7482/9082),因此 RDAP 是主要来源。RDAP 通过 IANA 引导注册表发现约 1200 个 TLD 的注册局 RDAP 服务,具有权威性:未注册域名返回 404,已注册返回 200。WHOIS 仅用于没有 RDAP 服务的 TLD(如 .io、.co、.me、.de、.es 等部分国家代码 TLD),通过 IANA 转介找到注册局 WHOIS 服务器并直接通过端口 43 查询,仅解释响应的前几行。DNS 用于解析成功的名称确定已注册。每个域名返回三种状态之一:可用、不可用或无法确定。无法确定状态的存在是因为旧版本在 WHOIS 查询出错时(包括机器未安装 whois 二进制文件)会报告域名可用,导致所有域名看似免费;现在无法信任的结果会被如此标记。域名并发检查,最多 10 个进行中,以遵守注册局速率限制。

结果包含:所请求域名的状态(如提供了特定 TLD)、可用域名(已确认未注册,按字母排序)、不可用域名(已确认注册)、无法确定域名(无权威答案并附原因)、汇总统计(按 TLD 类别细分:流行、国家、新 TLD)、性能指标(检查时长及回答来源:rdap、whois 或 dns)。

测试与命令行:可运行离线测试套件(无需网络),也可从命令行检查域名。

故障排除:连接错误时验证 uvx 安装(uvx --version,必要时重装 uv)、检查 Python 版本(3.10+)。MCP Python SDK 2.0 版本移除了 mcp.server.fastmcp,0.5.0 之前的版本未限制 SDK 版本导致启动失败;0.5.0 针对 SDK 2.x 编写。若仍见错误,刷新缓存安装:uvx --refresh --from git+https://github.com/imprvhub/mcp-domain-availability mcp-domain-availability;若为持久工具,运行 uv tool upgrade mcp-domain-availability;移除旧变通方法(如配置中的 "--with", "mcp<2.0.0")。DNS 解析问题:检查网络连接、DNS 服务器可访问性、速率限制(大型批量检查可能触发限制,工具使用信号量限制并发请求至 20)。MCP 服务器未启动:验证配置 JSON 语法、重启 Claude Desktop。

安全考虑:该工具对外部 DNS 服务器和 WHOIS 服务发起网络请求。域名查询可能被 DNS 提供商记录;WHOIS 查询通常被记录并可能受速率限制;除被检查的域名外不传输个人信息;所有查询均为只读,不修改任何外部系统。

项目使用 Mozilla Public License 2.0 许可。欢迎贡献,改进方向包括:增加更多 TLD 类别支持、实现缓存机制以加快重复查询、增强 WHOIS 解析以获取更详细域名信息、改进错误处理和重试机制。

限制:资料未提供收费、价格或商业使用条款的具体信息;未提供详细的 API 文档或完整配置示例;暂未提供其他未提及的功能或平台支持信息。