MCP Server Template Python

🚀 DNSDumpster - MCP Server

An MCP (Model Context Protocol) server for interacting with the DNSDumpster API, enabling AI assistants to perform detailed DNS reconnaissance via natural language requests.

🚀 Quick Start

The DNSDumpster - MCP Server allows AI assistants to interact with the DNSDumpster API, facilitating detailed DNS reconnaissance through natural - language requests.

✨ Features

• Query domain DNS records via AI assistants.
• Obtain detailed information:
  • A records (with relevant IP and ASN information).
  • CNAME records.
  • MX records.
  • TXT records.
  • NS records.
  • Obtain banner information when available.
• Support pagination (Plus accounts).
• Support domain map generation (Plus accounts).
• Rate limiting and caching.

📦 Installation

# Install from PyPI
uv pip install mcp-dnsdumpster

# Or install from source
git clone https://github.com/yourusername/mcp-dnsdumpster.git
cd mcp-dnsdumpster
uv pip install -e .

Configuration for Claude Desktop

Add the following to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %AppData%\Claude\claude_desktop_config.json on Windows):

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

💻 Usage Examples

Basic Usage

1. Set your API key:

export DNSDUMPSTER_API_KEY=your_api_key_here

2. Run the server:

# Use uvx (recommended)
uvx mcp-dnsdumpster

# Or if installed from source
uv run server.py

Advanced Usage

Here are some example prompts you can use:

• "Show all subdomains of example.com"
• "Tell me what the mail servers of microsoft.com are?"
• "Explain the DNS infrastructure of twitter.com"
• "Generate a visual map of the Facebook domain structure"

🔧 Technical Details

• Requirements: Python 3.10+
• Use uv for dependency management.
• Built on MCP SDK 1.4+.

📄 License

MIT