MCP Server Template Python

🚀 DNSDumpster - MCP 服务器

这是一个用于与 DNSDumpster API 交互的 MCP（模型上下文协议）服务器，借助它，AI 助手能通过自然语言请求开展详细的 DNS 侦察工作，为网络信息收集提供便利。

✨ 主要特性

• AI 查询功能：可通过 AI 助手查询域名的 DNS 记录。
• 丰富信息获取：能够获取详细的 DNS 信息，涵盖 A 记录（附带相关 IP 和 ASN 信息）、CNAME 记录、MX 记录、TXT 记录、NS 记录，在可用时还能获取 banner 信息。
• 高级账户支持：支持 Plus 账户进行分页查询，并且可以生成域名地图。
• 系统保障机制：具备限流和缓存功能，保障系统的稳定运行。

📦 安装指南

从 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 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json 在 macOS 上或 %AppData%\Claude\claude_desktop_config.json 在 Windows 上）：

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

使用方法

设置 API 密钥

export DNSDUMPSTER_API_KEY=your_api_key_here

运行服务器

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

# 或者如果从源码安装
uv run server.py

示例提示

• "显示 example.com 的所有子域名"
• "告诉我 microsoft.com 的邮件服务器是什么？"
• "讲一下 twitter.com 的 DNS 基础架构"
• "生成 Facebook 域名结构的可视化地图"

🔧 技术细节

• 开发需求：开发此项目需要 Python 3.10 及以上版本。
• 依赖管理：使用 uv 进行依赖管理。
• 技术基础：该项目建立在 MCP SDK 1.4 及以上版本基础上。

📄 许可证

本项目采用 MIT 许可证。