Domain Tools MCP Server

🚀 域名工具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）

1. 創建服務文件 /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

2. 啟用並啟動服務：

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

使用Docker

1. 創建 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"]

2. 構建並運行：

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 文件。

致謝

• dnspython
• python-whois
• pydantic
• MCP (Model Context Protocol)

作者

• Abhishek Deshpande(@deshabhishek007)

注意事項

• 此服務器旨在用作後端服務，或作為使用MCP協議進行通信的更大系統的一部分。
• 有關MCP的更多信息，請參閱 官方文檔。