FastDomainCheck MCP Server

FastDomainCheck MCP 服务

一种用于批量检查域名注册状态的模型上下文协议实现。

相关链接

• FastDomainCheck 在线服务 - 在线批量检查域名注册状态
• MCP 服务文档 - 详细的项目文档和技术规范

简介

FastDomainCheck MCP 服务是一种模型上下文协议（MCP）服务实现，可在 AI 工具（如 Claude）与域名可用性数据之间建立安全的双向连接。它遵循开放的 MCP 标准，确保与各种 AI 驱动的应用无缝兼容。

功能

• 批量检查域名注册状态
• 使用 WHOIS 和 DNS 进行双重验证
• 支持 IDN（国际化域名）
• 输出格式简洁
• 内置输入验证和错误处理

工具文档

check_domains

检查多个域名的注册状态。

输入格式

{
  "domains": ["example.com", "test.com"]
}

参数：

• domains：包含待检查域名的字符串数组
  • 每个域名的最大长度为 255 个字符
  • 每个请求最多包含 50 个域名
  • 不允许使用空域名

输出格式

{
  "results": {
    "example.com": {
      "registered": true
    },
    "test.com": {
      "registered": false
    }
  }
}

响应字段：

• results：以域名为键、检查结果为值的对象
  • registered：布尔值
    • true：域名已注册
    • false：域名可用

错误处理

以下情况会导致工具返回错误：

1. 域名列表为空
2. 请求中的域名超过 50 个
3. 域名为空
4. 域名长度超过 255 个字符
5. 结果序列化失败

错误响应格式：

{
  "error": "Error: domains list cannot be empty"
}

使用示例

检查多个域名：

请求

{
  "domains": ["example.com", "test123456.com"]
}

响应

{
  "results": {
    "example.com": {
      "registered": true
    },
    "test123456.com": {
      "registered": false
    }
  }
}

性能注意事项

1. 域名检查按顺序执行，每个域名约需 0.3-1 秒
2. 每个请求最多包含 50 个域名，以防止资源耗尽
3. WHOIS 查询超时设为 10 秒
4. WHOIS 查询失败时回退至 DNS 查询

错误处理策略

1. 输入验证：处理前进行全面验证
2. 双重验证：优先使用 WHOIS，失败时回退至 DNS
3. 超时管理：为所有网络操作设置合理的超时时间
4. 详细错误消息：提供清晰的错误说明以便排查问题

使用方法

下载二进制文件

从发布页面下载二进制文件。 https://github.com/bingal/FastDomainCheck-MCP-Server/releases

Mac/Linux

chmod +x FastDomainCheck-MCP-Server

MCP 服务设置

在 Claude Deskto 中配置 FastDomainCheck MCP

按下方所示修改 claude-desktop-config.json 文件

Mac/Linux

{
  "mcpServers": {
    "fastdomaincheck": {
      "command": "/path/to/FastDomainCheck-MCP-Server",
      "args": []
    }
  }
}

Windows

{
  "mcpServers": {
    "fastdomaincheck": {
      "command": "path/to/FastDomainCheck-MCP-Server.exe",
      "args": []
    }
  }
}

Python 版本

本项目的 Python 版本可在 fastdomaincheck-mcp-server 获取。

MCP 服务设置

{
  "mcpServers": {
    "fastdomaincheck": {
      "command": "uvx",
      "args": [
        "fastdomaincheck-mcp-server"
      ]
    }
  }
}

开发指南

要求

• Go 1.16 或更高版本
• 网络连接（用于 WHOIS 和 DNS 查询）
• 依赖项：
  • github.com/metoro-io/mcp-golang
  • 其他项目特定依赖项

构建

# Linux
go build -o FastDomainCheck-MCP-Server

# Windows
go build -o FastDomainCheck-MCP-Server.exe