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

Related MCP server: BasicSec MCP Server

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:

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

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