i

imprvhub

@imprvhub/mcp-domain-availability
0 Stars 9 次浏览 imprvhub 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "mcp-domain-availability": {
      "args": [
        "--python=3.10",
        "--from",
        "git+https://github.com/imprvhub/mcp-domain-availability",
        "mcp-domain-availability"
      ],
      "command": "uvx"
    },
    "otherMcp": {
      "args": [
        "..."
      ],
      "command": "..."
    }
  }
}

可用工具 (1 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

check_domain

Check domain availability. Usage examples: - mysite.com --domain - checks exact domain - mysite --domain - checks mysite across all popular TLDs - test.io --domain - checks test.io exactly, plus test across all TLDs Args: domain_query (str): Domain to check with --domain flag Returns: Dict containing availability results for the domain and suggested alternatives

该工具无需必填参数,直接调用即可

服务介绍

MCP 域名可用性检查器

smithery 徽章

功能

  • 域名可用性检查

    • 检查超过 50 种流行的 TLD 扩展
    • 支持流行 (.com, .io, .ai)、国家代码 (.us, .uk, .de) 和新 TLDs (.app, .dev, .tech)
    • 使用 DNS 和 WHOIS 双重验证以确保准确性
    • 按受欢迎程度组织智能 TLD 建议
  • 搜索功能

    • 通过精确匹配 TLD 来检查特定域名
    • 对给定名称支持扩展进行批量检查
    • 并行处理以加快域名查询速度
    • 按 TLD 类别组织结果
  • MCP 集成

    • 通过 uvx 包管理轻松设置
    • 与 Claude Desktop 无缝集成
    • 实时更新可用性状态
    • 性能指标和时间信息
  • AI 助手功能

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

演示

00:00 - 检查 google.com 的可用性
测试一个知名的优质域名,展示域名检查功能及替代 TLD 建议。

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

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

01:00 - 分析 aitools 域名
检查竞争激烈的 AI 行业域名,并分析市场上的可用性以用于初创公司命名。

要求

  • Python 3.10 或更高版本
  • Claude Desktop
  • uv 包管理器

依赖安装

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

官方安装程序(推荐):
bash
curl -LsSf https://astral.sh/uv/install.sh | sh

Homebrew(macOS/Linux):
bash
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
  • Windows: %APPDATA%Claudeclaude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json编辑此文件以添加 Domain Availability MCP 配置:

json
{
"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-domain-availability" 部分即可:

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

要通过 Smithery 自动为 Claude Desktop 安装 mcp-domain-availability:

bash
npx -y @smithery/cli install @imprvhub/mcp-domain-availability --client claude

手动安装

用于开发或本地测试:

  1. 克隆仓库:
    bash
    git clone https://github.com/imprvhub/mcp-domain-availability
    cd mcp-domain-availability

  2. 安装依赖项:
    bash
    uv sync

  3. 本地运行:
    bash
    uv run src/mcp_domain_availability/main.py

工作原理

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

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

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

可用工具

域名检查

工具名称 描述 用法
check_domain 使用 --domain 标志检查域名可用性 mysite.com --domainmysite --domain

支持的顶级域名类别

流行 TLD(12个)

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

国家 TLD(35个)

us, uk, ca, au, de, fr, 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

新 TLD

tech, online, site, website, store, shop, cloud, digital, blog, news & 更多。

示例用法

以下是如何使用 MCP 域名可用性检查器与 Claude 的示例:

单个域名检查

使用 --domain 检查 mysite.com 是否可用

域名研究

使用 --domain 检查 "startup" 在所有 TLD 上的可用性

特定域名验证

awesome.io 是否可用?使用 --domain 进行检查

输出格式

该工具提供的综合结果包括:

  • 请求的域名:查询的确切域名的状态(如果提供了特定 TLD)
  • 可用域名:按字母顺序排列的可用域名列表
  • 不可用域名:已注册的域名列表
  • 摘要统计:按 TLD 类别(流行、国家、新 TLD)细分
  • 性能指标:每个域名的检查持续时间

故障排除

"服务器断开连接" 错误

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

  1. 验证 uvx 安装

    • 运行 uvx --version 确保 uvx 正确安装
    • 如有必要,请重新安装 uv:curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 检查 Python 版本

    • 确保 Python 3.10+ 可用:python3 --version

DNS 解析问题

如果域名检查失败:

  1. 网络连接

    • 确认互联网连接稳定
    • 检查 DNS 服务器是否可访问
  2. 速率限制

    • 大批量检查可能会触发 DNS/WHOIS 服务的速率限制
    • 该工具使用信号量将并发请求数限制为 20#### 配置问题
      如果MCP服务器无法启动:
  3. 验证配置语法

    • 确保claude_desktop_config.json中的JSON语法有效
    • 检查所有括号和引号是否正确匹配
  4. 重启Claude Desktop

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

开发

项目结构

  • main.py:包含MCP服务器和域名检查逻辑的主入口点
  • 域名检查函数,包括DNS、WHOIS和套接字回退方法
  • TLD管理,使用分类列表
  • 异步处理以并行检查域名

构建

bash
uv build

测试

bash
uv run pytest

本地开发

bash
uv run main.py

安全注意事项

MCP域名可用性检查器会向DNS服务器和WHOIS服务发出外部网络请求。用户应注意以下几点:

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

贡献

欢迎贡献!改进领域包括:

  • 增加对更多TLD类别的支持
  • 实现缓存机制以加快重复查询的速度
  • 提升WHOIS解析功能以获取更详细的域名信息
  • 改进错误处理和重试机制

许可证

本项目采用Mozilla Public License 2.0许可 - 详情请参阅LICENSE文件。

相关链接

相关 MCP 服务