MCP Dnsdumpster

🚀 DNSDumpster - MCP 服務器

本項目藉助 AI 助手實現域名 DNS 記錄的查詢功能，能獲取 A、CNAME、MX 等多種記錄的詳細信息，還支持分頁查詢（Plus 賬戶），同時具備速率限制和緩存機制，為用戶提供高效穩定的 DNS 信息查詢服務。

🚀 快速開始

若想快速使用本項目，可按以下步驟操作：

1. 安裝項目（具體安裝方式見“📦 安裝指南”）。
2. 進行 Claude Desktop 配置（具體配置方法見“📚 詳細文檔”）。
3. 設置 API 密鑰並運行服務器（具體使用方法見“💻 使用示例”）。

✨ 主要特性

• AI 輔助查詢：通過 AI 助手查詢域名的 DNS 記錄。
• 多類型記錄獲取：可獲取 A 記錄（附帶關聯的 IP 和 ASN 信息）、CNAME 記錄、MX 記錄、TXT 記錄、NS 記錄以及可用的 banner 信息。
• 分頁支持：支持分頁查詢（適用於 Plus 賬戶）。
• 速率限制和緩存：具備速率限制和緩存機制，保障服務的穩定性和高效性。

📦 安裝指南

你可以選擇從 PyPI 安裝，也可以從源代碼安裝：

# 從 PyPI 安裝
uv pip install mcp-dnsdumpster

# 或從源代碼安裝
git clone https://github.com/yourusername/mcp-dnsdumpster.git
cd mcp-dnsdumpster
uv pip install -e .

📚 詳細文檔

Claude Desktop 配置

需將以下內容添加到您的 Claude Desktop 配置文件（macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %AppData%\Claude\claude_desktop_config.json）中：

{
  "mcpServers": {
    "dnsdumpster": {
      "command": "uvx",
      "args": ["mcp-dnsdumpster"],
      "env": {
        "DNSDUMPSTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

💻 使用示例

基礎用法

1. 設置 API 密鑰

export DNSDUMPSTER_API_KEY=your_api_key_here

2. 運行服務器

# 使用 uvx（推薦）
uvx mcp-dnsdumpster

# 或者如果從源代碼安裝
uv run server.py

高級用法

以下是一些示例提示，你可以根據需求進行查詢：

• "顯示 example.com 的所有子域名"
• "告訴我 microsoft.com 的郵件服務器是什麼？"
• "談談 twitter.com 的 DNS 基礎設施"

🔧 技術細節

• 開發環境：需要 Python 3.10+。
• 依賴管理：使用 uv 進行依賴管理。
• 構建工具：使用 MCP SDK 1.4+ 構建。

📄 許可證

本項目採用 MIT 許可證。