STARWARCLOUD STARWAR.AI
返回市场
远程MCP服务器模板

远程MCP服务器模板

作者：do-community27 星标更新：2025-07-12
安装使用来源：spider==github.com

项目介绍

远程MCP服务器模板

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

此特定实现：域名检查器

此模板演示了一个使用WHOIS查询和DNS解析的域名可用性检查器。它基于现代FastMCP框架构建，以确保可靠的域名可用性检查。

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

部署到DO

快速开始（一键部署）

  1. 使用上方按钮部署到DigitalOcean
  2. 从DigitalOcean获取您的已部署URL（例如，https://your-app.ondigitalocean.app）
  3. 使用URL加上/mcp端点添加到您的MCP客户端

图片

特性

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

使用您的远程MCP服务器

选项1：使用已部署的远程MCP服务器（推荐）

在部署到DigitalOcean后，将您的服务器URL添加到您的MCP客户端：

{
  "mcpServers": {
    "domain-checker": {
      "url": "https://YOUR-APP-NAME.ondigitalocean.app/mcp",
      "description": "检查域名可用性"
    }
  }
}

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

图片

选项2：使用FastMCP开发工具

# 确保您的虚拟环境已激活
fastmcp dev local-domain-checker.py

图片

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

此MCP服务器与Claude Desktop、Cursor、Windsurf和其他兼容MCP的应用程序一起工作。

配置位置

  • Claude Desktop：
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

图片

  • Cursor：
    • macOS: ~/Library/Application Support/Cursor/cursor_desktop_config.json
    • Windows: %APPDATA%\Cursor\cursor_desktop_config.json

安装MCP服务器

  • Windsurf：
    • macOS: ~/Library/Application Support/Windsurf/windsurf_desktop_config.json
    • Windows: %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
# 在macOS/Linux上
source venv/bin/activate
# 在Windows上
venv\Scripts\activate

  3. 安装依赖项

    pip install -r requirements.txt

部署到DigitalOcean应用平台

此MCP服务器可以在DigitalOcean应用平台上作为远程MCP服务器进行部署。

先决条件

  • 一个DigitalOcean账户
  • 命令行工具doctl（可选）
  • 包含您代码的Git仓库

部署步骤

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

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

    • 转到DigitalOcean应用平台仪表板
    • 单击“创建应用”并选择您的Git仓库
    • 选择要部署的分支
    • 选择“Python”作为环境

  3. 配置应用

    • 将源目录设置为/
    • 将运行命令设置为：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": "检查域名可用性"
    }
  }
}

更新您的部署

要更新已部署的应用，只需将更改推送到您的Git仓库。DigitalOcean应用平台会自动构建并部署新版本。

使用示例

检查单个域名

"检查myawesome-startup.com是否可用"

检查多个域名

"检查这些域名的可用性：mycompany.com, mycompany.net, mycompany.org"

理解结果

可用性状态

  • ✅ 可能可用：域名似乎未注册且可用
  • ❌ 不可用：域名已注册且不可用
  • ❓ 不明确：信号混合，建议手动验证

示例输出

域名：example-startup.com
状态：✅ 可能可用

WHOIS检查：可用
DNS解析：无法解析

详情：
{
  "whois": {
    "available": true,
    "reason": "WHOIS解析错误：无匹配的域名"
  },
  "dns": {
    "resolvable": false,
    "reason": "域名无法解析（NXDOMAIN）"
  }
}

故障排除

常见问题

1. 导入错误

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

2. 超时问题

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

3. DigitalOcean部署问题

  • 检查代码和应用平台配置中的端口是否均设置为8080
  • 验证所有依赖项都在requirements.txt中
  • 查看部署日志以查找任何错误消息

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