Domain Availability Checker MCP

MCP域可用性检查器

A Model Context Protocol (MCP) integration that provides Claude Desktop with domain availability checking across popular TLDs.

特性

• 域可用性检查

- 检查50多个流行TLD扩展的可用性 - 支持流行（.com、.io、.ai）、国家（.us、.uk、.de）和新顶级域名（.app、.dev、.tech） - 使用DNS和WHOIS进行双重验证以确保准确性 - 按受欢迎程度组织的智能TLD建议

• 搜索功能

- 检查具有精确TLD匹配的特定域名 - 对给定名称的支持扩展进行批量检查 - 并行处理以实现更快的域查询 - 按TLD类别组织结果

• MCP集成

- 使用uvx包管理轻松设置 - 与Claude Desktop无缝集成 - 实时可用性状态更新 - 性能指标和时间信息

• AI助手功能

- 通过Claude进行自然语言领域查询 - 自动域建议工作流 - 基于可用性的智能推荐

演示

Timestamps: Click on any timestamp to jump to that section of the video

00:00 - 正在检查google.com的可用性\ 测试一个知名的高级域名，以演示域名检查功能和替代TLD建议。

00:20 - 测试myawesomesite.com\ 验证自定义域名的可用性并探索其他扩展选项。

00:40 - 验证techstartup2026.io\ 探索科技初创公司的域名选项，并检查多个TLD扩展的可用性。

01:00 - 分析aitools域\ 检查竞争激烈的人工智能行业领域，分析初创企业命名的市场可用性。

需求

• Python 3.10或更高版本
• 克劳德桌面
• 紫外线 包管理器

依赖关系安装

使用以下方法之一安装uv包管理器：

官方安装程序（推荐）：

curl -LsSf https://astral.sh/uv/install.sh | sh

自制（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
• 视窗: %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域可用性”部分：

{
  "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安装

通过以下方式自动安装Claude Desktop的mcp域可用性 史密瑟里:

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

1. 安装依赖项：

uv sync

1. 在本地运行：

uv run src/mcp_domain_availability/main.py

使用Docker部署到Google Cloud Run

MCP服务器支持两种传输模式：

• 标准 （默认）：用于通过stdin/stdout集成Claude Desktop
• SSE：适用于HTTP/web部署，如Google Cloud Run

部署到Cloud Run时 MCP_TRANSPORT 环境变量必须设置为 sse.

先决条件：

• 谷歌云SDK 已安装并验证(gcloud auth login)
• 码头工人 已安装并正在运行
• 启用了Cloud Run和容器注册表API的Google Cloud项目

使用部署脚本

部署最简单的方法是使用 deploy.sh 脚本。

1. 编辑脚本：

打开 deploy.sh 并替换 ... 使用您的Google Cloud PROJECT_ID。您也可以更改 REGION 如果需要的话。

1. 运行脚本：

使脚本可执行并运行它。

    chmod +x deploy.sh
    ./deploy.sh

The script will build the Docker image, push it to Google Container Registry, and deploy it to Cloud Run with `MCP_TRANSPORT=sse`.

手动部署

或者，您可以手动运行这些命令。

1. 设置环境变量：

    export PROJECT_ID=""
    export REGION=""
    export IMAGE="gcr.io/$PROJECT_ID/mcp-domain-availability:latest"

1. 构建并推送Docker镜像：

    docker buildx build --platform linux/amd64 -t $IMAGE --push .

1. 部署到Google Cloud Run：

    gcloud run deploy mcp-domain-availability \
      --image $IMAGE \
      --region $REGION \
      --platform managed \
      --allow-unauthenticated \
      --port 8080 \
      --set-env-vars MCP_TRANSPORT=sse \
      --project $PROJECT_ID

注： 对于本地Claude Desktop使用，不需要环境变量。服务器默认为 stdio 运输方式。

运作原理

MCP域可用性检查器使用多种验证方法来确定域可用性：

1. DNS解析：检查域是否解析为IP地址
2. WHOIS查询：查询WHOIS数据库以获取注册信息
3. 套接字连接：当其他方法不可用时，回退到基于套接字的检查

该工具结合了这些方法的结果，以提供准确的可用性状态，并并行处理以同时检查多个域。

可用工具

域检查

支持的TLD类别

热门顶级域名（12）

com、net、org、io、ai、app、dev、co、xyz、me、info、biz

国家顶级域名（35）

美国、英国、加拿大、澳大利亚、德国、法国、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

新顶级域名

技术、在线、网站、网站、商店、商店、云、数字、博客、新闻等。

示例用法

以下是如何与Claude一起使用MCP域可用性检查器的示例：

单域检查

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

输出格式

该工具提供了全面的结果，包括：

• 请求的域：查询的确切域名的状态（如果提供了特定的TLD）
• 可用域名：按字母顺序排列的可用域列表
• 不可用的域：注册域名列表
• 概要统计：按顶级域名类别细分（热门、国家、新顶级域名）
• 性能指标：检查每个域的持续时间

故障排除

“服务器已断开连接”错误

如果您在Claude Desktop中看到连接错误：

1. 验证uvx安装:

- 跑 uvx --version 确保uvx安装正确 - 必要时重新安装uv： curl -LsSf https://astral.sh/uv/install.sh | sh

1. 检查Python版本:

- 确保Python 3.10+可用： python3 --version

DNS解析问题

如果域检查失败：

1. 网络连接:

- 验证互联网连接是否稳定 - 检查DNS服务器是否可访问

1. 速率限制:

- 大型批量检查可能会达到DNS/WHOIS服务的速率限制 - 该工具使用信号量将并发请求限制为20

配置问题

如果MCP服务器未启动：

1. 验证配置语法:

- 确保JSON语法在中有效 claude_desktop_config.json - 检查所有括号和引号是否正确匹配

1. 重新启动克劳德桌面:

- 配置更改后关闭并重新启动Claude Desktop

发展

项目结构

• main.py：MCP服务器和域检查逻辑的主要入口点
• 使用DNS、WHOIS和套接字回退方法的域检查功能
• 使用分类列表进行TLD管理
• 并行域检查的异步处理

建筑

uv build

测试

uv run pytest

地方发展

uv run main.py

安全考虑

MCP域可用性检查器向DNS服务器和WHOIS服务发出外部网络请求。用户应当注意：

• DNS提供商可能会记录域查询
• WHOIS查询通常会被记录，并且可能会受到费率限制
• 除了正在检查的域名外，不会传输任何个人信息
• 所有查询都是只读的，不会修改任何外部系统

贡献

欢迎投稿！需要改进的领域包括：

• 添加对其他TLD类别的支持
• 实现缓存机制以实现更快的重复查询
• 增强WHOIS解析以获取更详细的域信息
• 改进错误处理和重试机制

许可证

此项目根据Mozilla公共许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。

相关链接

• 模型上下文协议
• 克劳德桌面
• uv包管理器
• MCP系列