Domain Checker MCP

Domain Checker MCP

一个 MCP（Model Context Protocol）服务，使用 RDAP（Registration Data Access Protocol）检查域名是否可注册，并在必要时回退到 WHOIS。

功能

• 检查单个域名是否可注册
• 并行批量检查多个域名
• 查询域名时优先使用 RDAP
• RDAP 不可用时回退到 WHOIS
• 可配置并行工作进程（默认值：4）
• 针对速率限制响应的指数退避重试机制
• 增强域名状态检测（可注册、已注册、未知、速率受限）
• 提取域名信息（注册商、到期日期、距离到期的天数）
• 检测 registrationData 是否为 null，以提高可注册性判断的准确度
• 高效响应模式：默认不包含原始 RDAP/WHOIS 数据，以加快响应速度

MCP 配置

使用 npm 包

将此服务添加到 MCP 客户端配置中：

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

使用本地安装

{
  "mcpServers": {
    "domain-checker": {
      "command": "node",
      "args": ["/path/to/domain-checker-mcp/dist/index.js"]
    }
  }
}

安装

从 npm 安装

npm install -g domain-checker-mcp

从源代码安装

git clone https://github.com/yourusername/domain-checker-mcp.git
cd domain-checker-mcp
pnpm install
pnpm build

使用方法

运行 MCP 服务

pnpm start

可用工具

所有工具都支持可选的 includeRawResponse 参数（布尔值，默认值：false），用于控制是否在响应中包含原始 RDAP/WHOIS 数据。对于可疑情况（状态未知、速率受限、发生错误），系统会自动包含原始响应。

1. check_domain - 检查单个域名是否可注册

   • 输入：
     • domain（字符串）- 要检查的域名
     • includeRawResponse（布尔值，可选）- 是否包含原始响应数据（默认值：false）

2. check_domains_batch - 并行检查多个域名

   • 输入：
     • domains（字符串[]）- 要检查的域名数组
     • concurrency（数字，可选）- 并行工作进程数（1-10，默认值：4）
     • includeRawResponse（布尔值，可选）- 是否包含原始响应数据（默认值：false）

3. check_name_extensions - 检查单个名称在多个扩展名下的情况

   • 输入：
     • name（字符串）- 不带扩展名的域名名称（例如："example"）
     • extensions（字符串[]）- 要检查的扩展名数组（例如：["com", "net", "org"]）
     • concurrency（数字，可选）- 并行工作进程数（1-10，默认值：4）
     • includeRawResponse（布尔值，可选）- 是否包含原始响应数据（默认值：false）

4. check_names_extensions - 检查多个名称在多个扩展名下的情况

   • 输入：
     • names（字符串[]）- 不带扩展名的域名名称数组
     • extensions（字符串[]）- 要为每个名称检查的扩展名数组
     • concurrency（数字，可选）- 并行工作进程数（1-10，默认值：4）
     • includeRawResponse（布尔值，可选）- 是否包含原始响应数据（默认值：false）

响应格式

单个域名检查会返回：

{
  "domain": "example.com",
  "available": false,
  "status": "taken",
  "method": "rdap",
  "registrationData": { ... },
  "domainInfo": {
    "registrar": "Example Registrar Inc.",
    "expirationDate": "2025-12-31T23:59:59Z",
    "daysUntilExpiration": 365,
    "creationDate": "2020-01-01T00:00:00Z",
    "lastUpdated": "2024-01-15T12:00:00Z"
  }
}

批量检查会返回：

{
  "total": 5,
  "available": 2,
  "taken": 2,
  "errors": 0,
  "rateLimited": 1,
  "unknown": 0,
  "results": [...]
}

名称及扩展名检查会返回：

{
  "name": "example",
  "total": 3,
  "available": 1,
  "taken": 2,
  "errors": 0,
  "rateLimited": 0,
  "unknown": 0,
  "results": [...]
}

多个名称及扩展名检查会返回：

{
  "totalNames": 2,
  "totalExtensions": 3,
  "totalChecks": 6,
  "availableTotal": 2,
  "takenTotal": 3,
  "errorsTotal": 0,
  "rateLimitedTotal": 1,
  "unknownTotal": 0,
  "resultsByName": {
    "example": {
      "total": 3,
      "available": 1,
      "taken": 2,
      "errors": 0,
      "rateLimited": 0,
      "unknown": 0,
      "domains": [...]
    },
    ...
  }
}

发布

发布新版本：

1. 更新 package.json 中的版本号
2. 提交更改
3. 创建并推送新标签：

   git tag v0.1.0
   git push origin v0.1.0
   

4. GitHub Actions 将自动发布到 npm

要求

• 在 GitHub 仓库设置中设置 NPM_TOKEN 密钥
• 标签必须以 'v' 开头（例如：v0.1.0、v1.0.0）

许可证

MIT