Skip to main content
Glama

DNS MCP Server

by cenemil

@cenemiljezweb/dns-mcp-server

A TypeScript-based Model Context Protocol (MCP) server that provides comprehensive DNS lookup capabilities to AI assistants.

Installation

NPM Global Install

npm install -g @cenemiljezweb/dns-mcp-server

NPX (no install needed)

npx @cenemiljezweb/dns-mcp-server

Features

  • Multiple DNS Record Types: Support for A, AAAA, CNAME, MX, TXT, NS, SOA, PTR, SRV, and CAA records
  • Reverse DNS Lookups: Convert IP addresses back to hostnames
  • Batch Queries: Perform multiple DNS lookups in parallel or sequentially
  • DNS Trace: Trace the DNS resolution path from root servers to final result
  • Configurable DNS Servers: Use custom DNS servers (Google, Cloudflare, or your own)
  • Logging: Comprehensive logging with configurable levels
  • Error Handling: Robust error handling with detailed error messages

Quick Start

Using with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{ "mcpServers": { "dns-server": { "command": "npx", "args": ["@cenemiljezweb/dns-mcp-server"], "env": {} } } }

Or if installed globally:

{ "mcpServers": { "dns-server": { "command": "mcp-dns-server", "args": [], "env": {} } } }

Configuration

The server can be configured using a dns-config.json file in your working directory:

{ "dns": { "servers": ["8.8.8.8", "8.8.4.4", "1.1.1.1", "1.0.0.1"], "timeout": 5000, "retries": 2, "useTCP": false }, "cache": { "enabled": true, "ttl": 300, "maxSize": 1000 }, "logging": { "level": "info", "file": "dns-server.log" } }

MCP Tools Available

1. dns_lookup

Perform DNS lookup for a domain to retrieve various record types.

Parameters:

  • domain (required): The domain name to lookup
  • recordType: Type of DNS record (A, AAAA, CNAME, MX, TXT, NS, SOA, PTR, SRV, CAA)
  • useCustomServer: Use custom DNS server if configured
  • timeout: Query timeout in milliseconds

Example:

{ "domain": "example.com", "recordType": "A" }

2. reverse_dns

Perform reverse DNS lookup to find the hostname for an IP address.

Parameters:

  • ipAddress (required): The IP address to perform reverse lookup on
  • timeout: Query timeout in milliseconds

Example:

{ "ipAddress": "8.8.8.8" }

3. batch_dns

Perform multiple DNS lookups in a single operation.

Parameters:

  • queries (required): Array of DNS queries to perform
    • domain: Domain name
    • recordTypes: Array of record types to query
  • parallel: Execute queries in parallel (default: true)
  • timeout: Query timeout per request

Example:

{ "queries": [ {"domain": "example.com", "recordTypes": ["A", "MX"]}, {"domain": "google.com", "recordTypes": ["A", "AAAA"]} ], "parallel": true }

4. dns_trace

Trace the DNS resolution path from root servers to the final result.

Parameters:

  • domain (required): The domain to trace DNS resolution path
  • recordType: The record type to trace (default: A)

Example:

{ "domain": "example.com", "recordType": "A" }

Development

Local Development

# Clone the repository git clone https://github.com/yourusername/mcp-dns-server.git cd mcp-dns-server # Install dependencies npm install # Run in development mode npm run dev # Build the project npm run build # Run tests npm test

Scripts

  • npm run build - Compile TypeScript to JavaScript
  • npm run dev - Run in development mode with hot reload
  • npm start - Run the compiled server
  • npm test - Run unit tests
  • npm run lint - Run ESLint
  • npm run typecheck - Run TypeScript type checking

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Author

MCP DNS Server Contributors

Support

For issues and feature requests, please visit the GitHub repository.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables comprehensive DNS operations including lookups for various record types, reverse DNS queries, batch processing, and DNS resolution tracing. Supports multiple DNS servers with configurable caching and robust error handling.

  1. Installation
    1. NPM Global Install
    2. NPX (no install needed)
  2. Features
    1. Quick Start
      1. Using with Claude Desktop
    2. Configuration
      1. MCP Tools Available
        1. 1. dns_lookup
        2. 2. reverse_dns
        3. 3. batch_dns
        4. 4. dns_trace
      2. Development
        1. Local Development
        2. Scripts
      3. Contributing
        1. License
          1. Author
            1. Support

              Related MCP Servers

              • -
                security
                F
                license
                -
                quality
                Auto-generated MCP server that enables interaction with Google's Cloud DNS API for managing DNS zones and records through natural language.
                Last updated -
                Python
              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol tool that provides DNS querying capabilities for various record types (A, AAAA, MX, TXT, CNAME, NS, etc.) through a standardized MCP interface.
                Last updated -
                1
                TypeScript
                MIT License
              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol server implementation that allows AI agents to manage DNS records for domains hosted on Cloudflare by providing tools to list, create, update, and delete various types of DNS records.
                Last updated -
                5
                307
                JavaScript
                GPL 3.0

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/cenemil/dns-mcp-server'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server