DNS MCP Server

A Python MCP server providing comprehensive DNS lookup capabilities.

Features

• dns_lookup: Query any DNS record type (A, AAAA, MX, TXT, NS, SOA, CNAME, SRV, CAA, DNSSEC records)
• dns_reverse: Reverse DNS lookup (PTR) for IPv4/IPv6 addresses
• dns_bulk: Query multiple domains in one call
• dns_reverse_bulk: Reverse lookup for multiple IPs

Quick Start

docker compose up -d

The server will be available at https://localhost:8088/mcp.

Self-signed certificates are automatically generated on first startup.

Configuration

Environment variables:

Variable	Default	Description
HTTPS_PORT	8088	External HTTPS port
DOMAIN	localhost	Domain for certificate generation
MCP_HOST	0.0.0.0	Server bind address
MCP_PORT	8000	Server port
DNS_TIMEOUT	5	Query timeout in seconds
DNS_RETRIES	3	Max retry attempts
DEFAULT_RESOLVER	(system)	Default DNS resolver IP
LOG_LEVEL	INFO	Logging level

Claude Desktop Integration

To use this server with Claude Desktop, you'll need mcp-proxy to bridge the HTTP transport.

1. Install mcp-proxy

pip install mcp-proxy
# or
uv tool install mcp-proxy

2. Start the server

docker compose up -d

3. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "dns-lookup": {
      "command": "mcp-proxy",
      "args": [
        "--transport=streamablehttp",
        "--no-verify-ssl",
        "https://localhost:8088/mcp"
      ]
    }
  }
}

Note: Use the full path to mcp-proxy if Claude shows ENOENT errors (run which mcp-proxy to find it).

4. Restart Claude Desktop

The DNS tools will now be available in Claude Desktop.

Available Tools

Tool	Description
dns_lookup	Query DNS records (A, AAAA, MX, TXT, NS, etc.)
dns_reverse	Reverse DNS lookup for an IP address
dns_bulk	Query multiple domains at once
dns_reverse_bulk	Reverse lookup for multiple IPs

Development

Setup

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Run tests

pytest

Run locally (stdio mode)

dns-mcp-server

Run locally (HTTP mode)

dns-mcp-server-http

License

MIT