mcpField
N
NS Lookup MCP Server

NS Lookup MCP Server

Local
github.com/wgr1984Developer Tools1Updated 81w ago
Repository

About NS Lookup MCP Server

NS Lookup MCP Server exposes nslookup-based DNS lookups through an MCP interface. It supports forward and reverse lookups, configurable DNS server selection, and formatted results for clients that need DNS resolution.

Key features

  1. 01Perform forward DNS lookups
  2. 02Perform reverse DNS lookups
  3. 03Select a DNS server
  4. 04Return concise lookup results

Use cases

  1. 01Resolve a hostname to an address
  2. 02Look up a hostname from an IP address
  3. 03Run a lookup through a chosen DNS server

MCP support

Exposes an nslookup tool and prompt to MCP clients for forward and reverse DNS lookups.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.