域名检查服务

一个基于FastMCP框架的远程MCP服务器,提供域名可用性检查功能,支持WHOIS查询和DNS解析双重验证。

  • by ahramadan44
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ahramadan44/remote-mcp-server-template

使用说明

远程MCP服务器模板

这是一个用于创建的模板 远程MCP服务器 可以部署到DigitalOcean应用平台。远程MCP服务器允许您将MCP功能部署到云端,并从任何兼容MCP的客户端(Claude Desktop、Cursor、Windsurf等)使用它,而无需本地安装。

此特定实现:域检查器

此模板演示了一个使用WHOIS查找和DNS解析的域可用性检查器。采用现代FastMCP框架构建,用于可靠的域可用性检查。

将此远程MCP服务器部署到DigitalOcean

快速启动(单击部署)

  1. 部署到DigitalOcean 使用上面的按钮
  2. 获取已部署的URL 来自DigitalOcean(例如。, https://your-app.ondigitalocean.app)
  3. 添加到您的MCP客户端 使用URL+ /mcp 端点

特性

  • ✅ 双重验证:使用WHOIS和DNS解析以获得准确的结果
  • 🚀 异步操作:具有适当超时处理的非阻塞操作
  • 📊 批处理:同时检查多个域
  • 🔍 详细分析:提供全面的可用性信息

使用远程MCP服务器

选项1:使用已部署的远程MCP服务器(推荐)

部署到DigitalOcean后,将服务器URL添加到MCP客户端:

{
  "mcpServers": {
    "domain-checker": {
      "url": "https://YOUR-APP-NAME.ondigitalocean.app/mcp",
      "description": "Check domain availability"
    }
  }
}

替换 YOUR-APP-NAME 使用您的实际DigitalOcean应用程序名称。

选项2:使用FastMCP开发工具

# Make sure your virtual environment is activated
fastmcp dev local-domain-checker.py

选项3:配置本地MCP服务器

此MCP服务器可与Claude Desktop、Cursor、Windsurf和其他MCP兼容应用程序配合使用。

配置位置

  • 克劳德桌面版:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  • 光标:
    • macOS: ~/Library/Application Support/Cursor/cursor_desktop_config.json
    • 窗户: %APPDATA%\Cursor\cursor_desktop_config.json
  • 帆板运动:
    • macOS: ~/Library/Application Support/Windsurf/windsurf_desktop_config.json
    • 窗户: %APPDATA%\Windsurf\windsurf_desktop_config.json

将以下配置添加到相应的文件中,确保指向您的虚拟环境:

{
  "mcpServers": {
    "domain-checker": {
      "command": "/path/to/your/venv/bin/python",
      "args": ["/path/to/your/local-domain-checker.py"]
    }
  }
}

重要:

  • 用虚拟环境和域检查器目录的实际路径替换路径
  • 使用 local-domain-checker.py 用于本地开发(配置更简单,无需端口/主机设置)
  • domain-checker.py 已配置为使用其他参数进行远程部署

安装(供本地使用)

先决条件

  • Python 3.8或更高版本
  • pip包管理器

设置

  1. 克隆仓库

    git clone https://github.com/ajot/domain-checker-mcp-server.git
    cd domain-checker-mcp-server
    
  2. 创建并激活虚拟环境(推荐)

    python -m venv venv
    # On macOS/Linux
    source venv/bin/activate
    # On Windows
    venv\Scripts\activate
    
  3. 安装依赖项

    pip install -r requirements.txt
    

部署到DigitalOcean应用平台

此MCP服务器可以部署为DigitalOcean应用平台上的远程MCP服务器。

先决条件

  • DigitalOcean帐户
  • 这 doctl 命令行工具(可选)
  • 包含代码的Git存储库

部署步骤

  1. 将代码推送到Git存储库 确保所有更改都已提交并推送到GitHub、GitLab或Bitbucket存储库。

  2. 在DigitalOcean应用平台上创建新应用

    • 转到 数字海洋应用平台 仪表盘
    • 点击“创建应用程序”并选择您的Git存储库
    • 选择要部署的分支
    • 选择“Python”作为环境
  3. 配置应用程序

    • 将源目录设置为 /
    • 将run命令设置为: python domain-checker.py
    • 设置环境变量: PORT=8080
    • 将HTTP端口设置为8080
  4. 部署应用程序

    • 点击“部署到生产”
    • 等待构建和部署完成
  5. 配置为远程MCP 部署后,您可以将应用程序URL用作MCP兼容应用程序中的远程MCP服务器:

    {
      "mcpServers": {
        "domain-checker": {
          "url": "https://your-app-name.ondigitalocean.app/mcp",
          "description": "Check domain name availability"
        }
      }
    }
    

更新部署

要更新已部署的应用程序,只需将更改推送到Git存储库即可。DigitalOcean应用平台将自动构建和部署新版本。

使用示例

检查单个域

“检查myawesome-startup.com是否可用”

检查多个域

“检查以下域的可用性:mycompany.com、mycompany.net、mycompany.org”

了解结果

可用性状态

  • ✅ 可能可用:域似乎未注册且可用
  • ❌ 不可用:域已注册,不可用
  • ❓ 不清楚:混合信号-建议手动验证

样本输出

Domain: example-startup.com
Status: ✅ LIKELY AVAILABLE

WHOIS Check: Available
DNS Resolution: Not resolving

Details:
{
  "whois": {
    "available": true,
    "reason": "WHOIS parser error: No match for domain"
  },
  "dns": {
    "resolvable": false,
    "reason": "Domain does not resolve (NXDOMAIN)"
  }
}

故障排除

常见问题

1.导入错误

  • 确保您的虚拟环境已激活
  • 验证是否安装了所有依赖项: pip install -r requirements.txt

2.超时问题

  • 一些WHOIS服务器有速率限制
  • 网络连接问题可能导致超时

3.数字海洋部署问题

  • 检查代码和App Platform配置中的端口是否设置为8080
  • 验证所有依赖项是否都在requirements.txt中
  • 检查部署日志中是否有任何错误消息

免责声明:此工具提供域可用性的估计。在做出任何购买决定之前,始终通过官方域名注册商验证可用性。