🚀 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 许可证。