🚀 DNSDumpster - MCP 服务器
本项目借助 AI 助手实现域名 DNS 记录的查询功能，能获取 A、CNAME、MX 等多种记录的详细信息，还支持分页查询（Plus 账户），同时具备速率限制和缓存机制，为用户提供高效稳定的 DNS 信息查询服务。
🚀 快速开始
若想快速使用本项目，可按以下步骤操作：
- 安装项目（具体安装方式见“📦 安装指南”）。
- 进行 Claude Desktop 配置（具体配置方法见“📚 详细文档”）。
- 设置 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 许可证。