NS Lookup MCP Server
@wgr1984
A simple MCP Server that exposes the nslookup command functionality
Overview
What is NS Lookup MCP Server?
A simple MCP (Model Context Protocol) Server that exposes the nslookup command functionality via a REST API. It provides forward and reverse DNS lookup capabilities for integrating DNS resolution into applications.
How to use NS Lookup MCP Server?
Requires Python 3.9+ and the uv package manager. Clone the repository, install dependencies with uv pip install -e ., then start the server with uv run ns-lookup-mcp. For debugging, use npx @modelcontextprotocol/inspector uv run ns-lookup-mcp. Configure an MCP client by adding the provided JSON entry with the correct workspace path.
Key features of NS Lookup MCP Server
- Exposes nslookup command via a REST API
- Supports forward and reverse DNS lookups
- Configurable DNS server selection
- Clean and concise output formatting
- Modern Python tooling with uv and pyproject.toml
Use cases of NS Lookup MCP Server
- Perform forward DNS lookups for domain names
- Perform reverse DNS lookups for IP addresses
- Query specific DNS servers (e.g., Google, Cloudflare, OpenDNS)
- Integrate DNS resolution into MCP‑enabled workflows
FAQ from NS Lookup MCP Server
What are the system requirements for NS Lookup MCP Server?
Python 3.9 or higher and the uv package manager are required.
How do I install and run NS Lookup MCP Server?
Clone the repository, run uv pip install -e . to install dependencies, then start with uv run ns-lookup-mcp.
What parameters does the nslookup tool accept?
It accepts a required hostname (domain or IP) and an optional server (DNS server to use).
Can I specify a custom DNS server for a lookup?
Yes, you can provide the server parameter to use a specific DNS server, such as 8.8.8.8 or 1.1.1.1.
What output format does NS Lookup MCP Server return?
The server returns a clean, concise format showing DNS server, queried name, and resolved address.
