NS Lookup MCP Server
About
A simple MCP Server that exposes the nslookup command functionality
Details
- Author
- wgr1984
- Downloads
- 141
- Categories
- Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
NS Lookup MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ns lookup mcp server": {
"ns-lookup-mcp": {
"command": "uv",
"args": [
"pip",
"install",
"-e",
"."
]
}
}
}
}McpServers
{
"ns-lookup-mcp": {
"command": "uv",
"args": [
"pip",
"install",
"-e",
"."
]
}
}NS Lookup MCP Server
A simple MCP (Model Context Protocol) Server that exposes the nslookup command functionality. This service provides a REST API interface to perform DNS lookups, making it easy to integrate DNS resolution capabilities into your applications.
Features
- Exposes nslookup command functionality via a REST API
- Simple and focused microservice
- Modern Python tooling with uv and pyproject.toml
- Supports both forward and reverse DNS lookups
- Configurable DNS server selection
- Clean and concise output formatting
Requirements
- Python 3.9 or higher
- uv (Python package manager)
Installation
1. Clone the repository
2. Install dependencies using uv:
uv pip install -e .
Usage
Start the server:
uv run ns-lookup-mcp
Debug mode:
npx @modelcontextprotocol/inspector uv run ns-lookup-mcp
MCP Interface
Tools
The server exposes the following tool:
{
"name": "nslookup",
"description": "Performs DNS lookups using the nslookup command. Supports both forward and reverse DNS lookups.",
"inputSchema": {
"type": "object",
"properties": {
"hostname": {
"type": "string",
"description": "Domain name or IP address to look up"
},
"server": {
"type": "string",
"description": "Optional DNS server to use for the lookup"
}
},
"required": ["hostname"]
}
}
Prompts
The server provides the following prompt:
{
"name": "nslookup",
"description": "Perform a DNS lookup using nslookup",
"arguments": [
{
"name": "hostname",
"description": "Domain name or IP address to look up",
"required": true
},
{
"name": "server",
"description": "Optional DNS server to use",
"required": false
}
]
}
MCP Client Configuration
To use this server with an MCP client, add the following configuration to your client's settings:
{
"mcpServers": {
"nslookup": {
"command": "uv",
"args": [
"run",
"--directory",
"[workspace]/ns-lookup-mcp",
"ns-lookup-mcp"
]
}
}
}
Replace [workspace] with the actual path to your workspace directory.
Example Output
The server returns DNS lookup results in a clean, concise format:
DNS: 192.168.1.1
Name: example.com
Address: 93.184.216.34
Common DNS Servers
- Google DNS: 8.8.8.8
- Cloudflare DNS: 1.1.1.1
- OpenDNS: 208.67.222.222
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
