Skip to main content
Glama

DNS MCP Server

by cenemil
npmGitHub
TypeScript
MIT License
7
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

@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.

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

How are these scores calculated?

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.

Tools

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

              • MCP DNS

                glucn
                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
                MIT License

              • Domain Tools MCP Server

                deshabhishek007
                -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that provides comprehensive domain analysis capabilities including WHOIS lookups, DNS record queries, and DNS health checking.
                Last updated -
                4
                MIT License
                • Linux

              • Cloudflare MCP Server

                jeffgolden
                A
                security
                A
                license
                A
                quality
                Exposes Cloudflare DNS, security, redirects and zone-settings functionality as structured tools that AI assistants like Claude Desktop can invoke directly.
                Last updated -
                18
                MIT License

              • Enhanced Directory Context MCP Server

                PWalaGov
                A
                security
                F
                license
                A
                quality
                Enables comprehensive directory analysis and file management operations including project structure exploration, intelligent file search, full CRUD operations on files and directories, batch operations with rollback capabilities, and Git integration.
                Last updated -
                13
                3

              View all related MCP servers

              Appeared in Searches

              New 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