Domain Checker MCP

🚀 域名检查器MCP服务器

这是一个专为模型上下文协议（MCP）打造的快速域名可用性检查器，支持DNS + RDAP/WHOIS验证。本项目由Brave Labs开发。

🚀 快速开始

本域名检查器可快速检查域名可用性，结合了DNS和RDAP/WHOIS验证，为你提供准确的域名状态信息。

✨ 主要特性

• 混合DNS + RDAP/WHOIS检查：先进行快速的DNS查询，再通过RDAP（若失败则使用WHOIS）进行精确验证。
• 批量检查：可并行检查多达100个域名。
• 并行处理：采用批量验证查询，实现最优吞吐量。
• 名称扩展：可自动检查一个基础名称在所有流行顶级域名（TLD）下的可用性。
• 灵活过滤：可仅返回可用域名、已占用域名或全部结果。
• 错误报告：针对超时和失败情况提供清晰的错误处理。

📦 安装指南

npm install -g @wearebravelabs/domain-checker-mcp

📚 详细文档

配置

Claude桌面版

在claude_desktop_config.json中添加以下内容：

{
  "mcpServers": {
    "domain-checker": {
      "command": "npx",
      "args": ["-y", "@wearebravelabs/domain-checker-mcp"]
    }
  }
}

Claude代码版

在MCP设置中添加以下内容：

{
  "mcpServers": {
    "domain-checker": {
      "command": "npx",
      "args": ["-y", "@wearebravelabs/domain-checker-mcp"]
    }
  }
}

工具

check_domains

通过完整的DNS + WHOIS验证检查特定域名的可用性。

// 检查多个域名
check_domains({
  domains: ["myapp.com", "myapp.io", "myapp.dev"]
})

// 仅过滤出可用域名
check_domains({
  domains: ["example.com", "randomname123.com"],
  filter: "available"
})

参数说明：

• domains（必填）：要检查的域名数组。
• filter（选填）："available" 或 "taken"，不填则返回所有结果。

check_names

自动检查基础名称在流行顶级域名（TLD）下的可用性。

// 检查 "myproject" 在所有流行顶级域名下的可用性
check_names({
  names: ["myproject"]
})

// 检查多个名称在特定顶级域名下的可用性
check_names({
  names: ["startup", "launchpad"],
  tlds: ["com", "io", "co", "app"],
  filter: "available"
})

参数说明：

• names（必填）：要检查的基础名称数组。
• tlds（选填）：要检查的特定顶级域名，默认值为：com, net, org, io, co, app, dev, ai, xyz, me, info, biz, us, uk, ca, au。
• filter（选填）："available" 或 "taken"，不填则返回所有结果。

check_domains_quick

仅进行快速的DNS检查，不进行WHOIS验证。适用于对速度要求高于准确性的场景。

check_domains_quick({
  domains: ["example.com", "test.io"]
})

参数说明：

• domains（必填）：要检查的域名数组。
• filter（选填）："available" 或 "taken"，不填则返回所有结果。

注意：仅进行DNS检查可能会对可用域名显示误报。请使用 check_domains 进行验证。

示例响应

{
  "summary": {
    "total": 4,
    "available": 2,
    "taken": 2,
    "errors": 0,
    "totalTime": "634ms"
  },
  "available": [
    "myproject.io",
    "myproject.dev"
  ],
  "taken": [
    "myproject.com",
    "myproject.app"
  ]
}

包含错误信息的响应：

{
  "summary": {
    "total": 3,
    "available": 1,
    "taken": 1,
    "errors": 1,
    "totalTime": "10234ms"
  },
  "available": ["available-domain.com"],
  "taken": ["google.com"],
  "errors": [
    { "domain": "example.xyz", "error": "WHOIS timeout" }
  ]
}

工作原理

1. DNS检查（快速）：所有域名通过DNS并行检查。若DNS解析成功，则该域名肯定已被占用。
2. RDAP/WHOIS验证（准确）：通过DNS检查（未找到记录）的域名将通过RDAP（首选）或WHOIS（备用）进行验证，以确认其可用性。RDAP服务器从IANA引导注册表动态加载。
3. 并行处理：验证查询以20个为一批并行运行，以实现最优吞吐量。

这种混合方法结合了DNS检查的速度和RDAP/WHOIS验证的准确性。

开发

# 安装依赖
npm install

# 构建项目
npm run build

# 本地运行
npm start

更多来自Brave Labs的内容

bravelabs.com.au

📄 许可证

本项目采用MIT许可协议，版权归Brave Labs所有。