Provides DNS lookup capabilities using 1.1.1.1 as a configurable DNS server option for domain resolution queries
Provides DNS lookup capabilities using Cloudflare's DNS servers as a configurable option for domain resolution queries
Provides DNS lookup capabilities using Google's DNS servers (8.8.8.8, 8.8.4.4) as configurable options for domain resolution queries
@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
NPX (no install needed)
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):
Or if installed globally:
Configuration
The server can be configured using a dns-config.json
file in your working directory:
MCP Tools Available
1. dns_lookup
Perform DNS lookup for a domain to retrieve various record types.
Parameters:
domain
(required): The domain name to lookuprecordType
: Type of DNS record (A, AAAA, CNAME, MX, TXT, NS, SOA, PTR, SRV, CAA)useCustomServer
: Use custom DNS server if configuredtimeout
: Query timeout in milliseconds
Example:
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 ontimeout
: Query timeout in milliseconds
Example:
3. batch_dns
Perform multiple DNS lookups in a single operation.
Parameters:
queries
(required): Array of DNS queries to performdomain
: Domain namerecordTypes
: Array of record types to query
parallel
: Execute queries in parallel (default: true)timeout
: Query timeout per request
Example:
4. dns_trace
Trace the DNS resolution path from root servers to the final result.
Parameters:
domain
(required): The domain to trace DNS resolution pathrecordType
: The record type to trace (default: A)
Example:
Development
Local Development
Scripts
npm run build
- Compile TypeScript to JavaScriptnpm run dev
- Run in development mode with hot reloadnpm start
- Run the compiled servernpm test
- Run unit testsnpm run lint
- Run ESLintnpm 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.
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.
Related MCP Servers
- -securityFlicense-qualityAuto-generated MCP server that enables interaction with Google's Cloud DNS API for managing DNS zones and records through natural language.Last updated -Python
- AsecurityAlicenseAqualityA 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 -1TypeScriptMIT License
- -securityAlicense-qualityDomain Tools (WHOIS + DNS)Last updated -6GoMIT License
- AsecurityAlicenseAqualityA 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 -5307JavaScriptGPL 3.0