{"_id":"@cenemiljezweb/dns-mcp-server","_rev":"2-415eaac8421823c44d02d90492f4e0bf","name":"@cenemiljezweb/dns-mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@cenemiljezweb/dns-mcp-server","version":"1.0.0","keywords":["mcp","dns","lookup","network","model-context-protocol","claude","ai"],"author":"","license":"MIT","_id":"@cenemiljezweb/dns-mcp-server@1.0.0","maintainers":[{"name":"cenemiljezweb","email":"cenemil@jezweb.net"}],"homepage":"https://github.com/yourusername/mcp-dns-server#readme","bugs":{"url":"https://github.com/yourusername/mcp-dns-server/issues"},"bin":{"mcp-dns-server":"dist/index.js"},"dist":{"shasum":"d0646a155b210d7a1b3c1c99d2915925d801769b","tarball":"https://registry.npmjs.org/@cenemiljezweb/dns-mcp-server/-/dns-mcp-server-1.0.0.tgz","fileCount":27,"integrity":"sha512-/EzHh5ojObcDYB7PmuDqcG9vky8viv/jUIf+3bJcJDc/VBtS3jGipVFB+9CyhQRJbBmpLbRupf3vcC3U/x+skg==","signatures":[{"sig":"MEQCIE24VM3HVxotHBv1q4lOt+qLyz9C6cMtemV20kigzjs/AiBn5q5PvXjOxXvClzM6M8MT+Y1HWkqo2kGNQae3mXhMIQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61327},"main":"dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"453afcaa5d5132bf911d28fd0120815dbde12cf4","scripts":{"dev":"tsx src/index.ts","lint":"eslint src --ext .ts","test":"jest","build":"tsc","start":"node dist/index.js","typecheck":"tsc --noEmit","postinstall":"echo 'Add to Claude Desktop config: npx @cenemiljezweb/dns-mcp-server'","prepublishOnly":"npm run build"},"_npmUser":{"name":"cenemiljezweb","email":"cenemil@jezweb.net"},"repository":{"url":"git+https://github.com/yourusername/mcp-dns-server.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for DNS lookups and network diagnostics","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.24.1","dns-packet":"^5.6.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","jest":"^29.7.0","eslint":"^9.18.0","ts-jest":"^29.2.5","typescript":"^5.7.3","@types/jest":"^29.5.14","@types/node":"^22.10.5","@types/dns-packet":"^5.6.5","@typescript-eslint/parser":"^8.21.0","@typescript-eslint/eslint-plugin":"^8.21.0"},"_npmOperationalInternal":{"tmp":"tmp/dns-mcp-server_1.0.0_1754465302487_0.17551621120112348","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@cenemiljezweb/dns-mcp-server","version":"1.0.1","description":"MCP server for DNS lookups and network diagnostics","main":"dist/index.js","bin":{"mcp-dns-server":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","test":"jest","lint":"eslint src --ext .ts","typecheck":"tsc --noEmit","prepublishOnly":"npm run build","postinstall":"echo 'Add to Claude Desktop config: npx @cenemiljezweb/dns-mcp-server'"},"keywords":["mcp","dns","lookup","network","model-context-protocol","claude","ai"],"author":"","license":"MIT","repository":{"type":"git","url":"git+https://github.com/cenemil/dns-mcp-server.git"},"bugs":{"url":"https://github.com/cenemil/dns-mcp-server/issues"},"homepage":"https://github.com/cenemil/dns-mcp-server#readme","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","dns-packet":"^5.6.1","zod":"^3.24.1"},"devDependencies":{"@types/dns-packet":"^5.6.5","@types/jest":"^29.5.14","@types/node":"^22.10.5","@typescript-eslint/eslint-plugin":"^8.21.0","@typescript-eslint/parser":"^8.21.0","eslint":"^9.18.0","jest":"^29.7.0","ts-jest":"^29.2.5","tsx":"^4.19.2","typescript":"^5.7.3"},"_id":"@cenemiljezweb/dns-mcp-server@1.0.1","gitHead":"471f62eb788c31f558c4924d3ae3f2275088f74c","types":"./dist/index.d.ts","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-HOlG/Yk602C3BQ6sOw/CQCwjfooKrwUW7maucPuZbtfBM1F6I82KVzPU6Qdw/0/OmHmx6phIW583WjbSVRihww==","shasum":"47d9a63bc5e423ae7d2b4c283e8bd6bbfe86b5fe","tarball":"https://registry.npmjs.org/@cenemiljezweb/dns-mcp-server/-/dns-mcp-server-1.0.1.tgz","fileCount":27,"unpackedSize":61312,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHElOC7X42oTwjDhvNTTYdABAAga8hG9AQPgUSN0eVfuAiBt9m4cjxTCfpXMHSIp4/qqsrKEuTKbZKn9tZ3kBPaT3A=="}]},"_npmUser":{"name":"cenemiljezweb","email":"cenemil@jezweb.net"},"directories":{},"maintainers":[{"name":"cenemiljezweb","email":"cenemil@jezweb.net"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dns-mcp-server_1.0.1_1754527950526_0.23317024934835562"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-06T07:28:22.381Z","modified":"2025-08-07T00:52:30.896Z","1.0.0":"2025-08-06T07:28:22.649Z","1.0.1":"2025-08-07T00:52:30.722Z"},"bugs":{"url":"https://github.com/cenemil/dns-mcp-server/issues"},"license":"MIT","homepage":"https://github.com/cenemil/dns-mcp-server#readme","keywords":["mcp","dns","lookup","network","model-context-protocol","claude","ai"],"repository":{"type":"git","url":"git+https://github.com/cenemil/dns-mcp-server.git"},"description":"MCP server for DNS lookups and network diagnostics","maintainers":[{"name":"cenemiljezweb","email":"cenemil@jezweb.net"}],"readme":"# @cenemiljezweb/dns-mcp-server\n\nA TypeScript-based Model Context Protocol (MCP) server that provides comprehensive DNS lookup capabilities to AI assistants.\n\n## Installation\n\n### NPM Global Install\n```bash\nnpm install -g @cenemiljezweb/dns-mcp-server\n```\n\n### NPX (no install needed)\n```bash\nnpx @cenemiljezweb/dns-mcp-server\n```\n\n## Features\n\n- **Multiple DNS Record Types**: Support for A, AAAA, CNAME, MX, TXT, NS, SOA, PTR, SRV, and CAA records\n- **Reverse DNS Lookups**: Convert IP addresses back to hostnames\n- **Batch Queries**: Perform multiple DNS lookups in parallel or sequentially\n- **DNS Trace**: Trace the DNS resolution path from root servers to final result\n- **Configurable DNS Servers**: Use custom DNS servers (Google, Cloudflare, or your own)\n- **Logging**: Comprehensive logging with configurable levels\n- **Error Handling**: Robust error handling with detailed error messages\n\n## Quick Start\n\n### Using with Claude Desktop\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"dns-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"@cenemiljezweb/dns-mcp-server\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\nOr if installed globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"dns-server\": {\n      \"command\": \"mcp-dns-server\",\n      \"args\": [],\n      \"env\": {}\n    }\n  }\n}\n```\n\n## Configuration\n\nThe server can be configured using a `dns-config.json` file in your working directory:\n\n```json\n{\n  \"dns\": {\n    \"servers\": [\"8.8.8.8\", \"8.8.4.4\", \"1.1.1.1\", \"1.0.0.1\"],\n    \"timeout\": 5000,\n    \"retries\": 2,\n    \"useTCP\": false\n  },\n  \"cache\": {\n    \"enabled\": true,\n    \"ttl\": 300,\n    \"maxSize\": 1000\n  },\n  \"logging\": {\n    \"level\": \"info\",\n    \"file\": \"dns-server.log\"\n  }\n}\n```\n\n## MCP Tools Available\n\n### 1. dns_lookup\nPerform DNS lookup for a domain to retrieve various record types.\n\n**Parameters:**\n- `domain` (required): The domain name to lookup\n- `recordType`: Type of DNS record (A, AAAA, CNAME, MX, TXT, NS, SOA, PTR, SRV, CAA)\n- `useCustomServer`: Use custom DNS server if configured\n- `timeout`: Query timeout in milliseconds\n\n**Example:**\n```json\n{\n  \"domain\": \"example.com\",\n  \"recordType\": \"A\"\n}\n```\n\n### 2. reverse_dns\nPerform reverse DNS lookup to find the hostname for an IP address.\n\n**Parameters:**\n- `ipAddress` (required): The IP address to perform reverse lookup on\n- `timeout`: Query timeout in milliseconds\n\n**Example:**\n```json\n{\n  \"ipAddress\": \"8.8.8.8\"\n}\n```\n\n### 3. batch_dns\nPerform multiple DNS lookups in a single operation.\n\n**Parameters:**\n- `queries` (required): Array of DNS queries to perform\n  - `domain`: Domain name\n  - `recordTypes`: Array of record types to query\n- `parallel`: Execute queries in parallel (default: true)\n- `timeout`: Query timeout per request\n\n**Example:**\n```json\n{\n  \"queries\": [\n    {\"domain\": \"example.com\", \"recordTypes\": [\"A\", \"MX\"]},\n    {\"domain\": \"google.com\", \"recordTypes\": [\"A\", \"AAAA\"]}\n  ],\n  \"parallel\": true\n}\n```\n\n### 4. dns_trace\nTrace the DNS resolution path from root servers to the final result.\n\n**Parameters:**\n- `domain` (required): The domain to trace DNS resolution path\n- `recordType`: The record type to trace (default: A)\n\n**Example:**\n```json\n{\n  \"domain\": \"example.com\",\n  \"recordType\": \"A\"\n}\n```\n\n## Development\n\n### Local Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/mcp-dns-server.git\ncd mcp-dns-server\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Build the project\nnpm run build\n\n# Run tests\nnpm test\n```\n\n### Scripts\n\n- `npm run build` - Compile TypeScript to JavaScript\n- `npm run dev` - Run in development mode with hot reload\n- `npm start` - Run the compiled server\n- `npm test` - Run unit tests\n- `npm run lint` - Run ESLint\n- `npm run typecheck` - Run TypeScript type checking\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT\n\n## Author\n\nMCP DNS Server Contributors\n\n## Support\n\nFor issues and feature requests, please visit the [GitHub repository](https://github.com/yourusername/mcp-dns-server/issues).","readmeFilename":"README.md"}