金大哥 - domain-tools-mcp-server MCP 详情

article

README

🚀 域名工具MCP服务器

域名工具MCP服务器是一个用于综合域名分析的Model Context Protocol（MCP）服务器，可进行WHOIS查询、DNS记录查询和DNS健康检查，帮助用户深入分析和监控域名配置。

🚀 快速开始

前提条件

推荐使用Python 3.13+ 。
安装pip（Python包管理器）。
需要网络连接以进行DNS/WHOIS查询。

安装步骤

1. 克隆仓库

git clone https://github.com/deshabhishek007/domain-tools-mcp-server.git
cd domain-tools-mcp-server

2. 创建虚拟环境（推荐）

python3 -m venv domain-tools-env
source domain-tools-env/bin/activate

3. 安装依赖

pip install -r requirements.txt

4. 验证安装

python -c "import mcp, dns.resolver, whois; print('All dependencies installed successfully!')"

部署方式

本地开发

python domain_tools_server.py

或者使其可执行：

chmod +x domain_tools_server.py
./domain_tools_server.py

生产环境部署

使用systemd（Linux）

创建服务文件 /etc/systemd/system/domain-tools-mcp.service：

[Unit]
Description=Domain Tools MCP Server
After=network.target

[Service]
Type=simple
User=your-username
WorkingDirectory=/path/to/your/project
Environment=PATH=/path/to/your/project/domain-tools-env/bin
ExecStart=/path/to/your/project/domain-tools-env/bin/python domain_tools_server.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

启用并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable domain-tools-mcp.service
sudo systemctl start domain-tools-mcp.service

使用Docker

创建 Dockerfile：

FROM python:3.13-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY domain_tools_server.py .
EXPOSE 8080
CMD ["python", "domain_tools_server.py"]

构建并运行：

docker build -t domain-tools-mcp .
docker run -p 8080:8080 domain-tools-mcp

✨ 主要特性

WHOIS信息查询：获取详细的域名注册数据。
DNS记录查询：支持查询多种DNS记录类型（A、AAAA、MX、NS、TXT、CNAME、SOA）。
DNS健康检查：识别常见的DNS配置问题。
综合分析：一站式完成域名评估。

📦 项目结构

.
├── domain_tools_server.py   # 主服务器实现
├── requirements.txt
├── .gitignore
├── README.md
└── ...

💻 使用示例

基础用法

MCP客户端集成

服务器实现了Model Context Protocol，可以与任何兼容MCP的客户端集成。 示例MCP客户端配置：

{
  "servers": {
    "domain-tools": {
      "command": "python",
      "args": ["/path/to/domain_tools_server.py"],
      "env": {}
    }
  }
}

📚 详细文档

API参考

可用工具

1. WHOIS查询

参数：
- domain（字符串，必填）：要查询的域名。
示例请求：

{
  "tool": "whois_lookup",
  "arguments": {
    "domain": "example.com"
  }
}

示例输出：

{
  "domain": "example.com",
  "registrar": "Example Registrar Inc.",
  "creation_date": "2023-01-15T00:00:00Z",
  "expiration_date": "2025-01-15T00:00:00Z",
  "updated_date": "2024-01-15T00:00:00Z",
  "status": ["clientTransferProhibited"],
  "name_servers": ["ns1.example.com", "ns2.example.com"],
  "days_until_expiry": 215
}

2. DNS记录查询

参数：
- domain（字符串，必填）：要查询的域名。
- record_types（数组，可选）：要查询的DNS记录类型（默认：["A", "AAAA", "MX", "NS", "TXT", "CNAME", "SOA"]）。
示例请求：

{
  "tool": "dns_records",
  "arguments": {
    "domain": "example.com",
    "record_types": ["A", "MX", "NS"]
  }
}

3. DNS健康检查

参数：
- domain（字符串，必填）：要分析的域名。
示例请求：

{
  "tool": "dns_health_check",
  "arguments": {
    "domain": "example.com"
  }
}

4. 完整域名分析

参数：
- domain（字符串，必填）：要分析的域名。
示例请求：

{
  "tool": "domain_analysis",
  "arguments": {
    "domain": "example.com"
  }
}

工具架构

每个工具都遵循JSON输入架构。完整细节请查看代码。

响应格式

所有工具返回的响应格式如下：

[
  {
    "type": "text",
    "text": "Tool-specific formatted output"
  }
]

配置

DNS解析器

可以在服务器代码中自定义DNS解析器：

self.dns_resolver.nameservers = ['8.8.8.8', '8.8.4.4']
self.dns_resolver.timeout = 10
self.dns_resolver.lifetime = 30

环境变量

可以使用环境变量配置服务器：

export DNS_TIMEOUT=10
export DNS_LIFETIME=30
export WHOIS_TIMEOUT=30
export SERVER_NAME="domain-tools"
export SERVER_VERSION="1.0.0"

🔧 技术细节

故障排除

常见问题

导入错误：运行 pip install --upgrade mcp dnspython python-whois pydantic。
DNS解析失败：
- 检查网络连接。
- 尝试不同的DNS服务器。
- 增加超时时间。
WHOIS查询失败：
- 某些域名可能限制了WHOIS访问。
- 可能存在速率限制。
权限错误：
- 使用适当的权限运行。
- 测试时使用非特权端口。

调试模式

在服务器中添加以下代码启用调试日志：

import logging
logging.basicConfig(level=logging.DEBUG)

安全考虑

输入验证：始终验证域名输入。
速率限制：实施速率限制以防止滥用。
网络安全：使用安全的DNS解析器。
日志记录：记录所有查询以进行审计。
访问控制：必要时实施身份验证。

📄 许可证

本项目采用MIT许可证。详情请参阅 LICENSE 文件。

致谢

作者

Abhishek Deshpande(@deshabhishek007)

注意事项

此服务器旨在用作后端服务，或作为使用MCP协议进行通信的更大系统的一部分。
有关MCP的更多信息，请参阅官方文档。