Ns Lookup MCP

🚀 NSLOOKUP Server MCP Service

A simple MCP (Model Context Protocol) server that exposes the functionality of the nslookup command. This service provides DNS query capabilities through a REST API, allowing you to easily integrate DNS resolution into your applications.

🚀 Quick Start

This NSLOOKUP Server MCP Service is a straightforward way to integrate DNS query capabilities into your applications. With a few simple steps, you can get the service up and running.

✨ Features

• REST API Interface: Exposes a REST API for the nslookup command.
• Simple Microservice: A simple and focused microservice.
• Modern Python Tools: Utilizes modern Python tools like uv and pyproject.toml.
• Bidirectional DNS Queries: Supports both forward and reverse DNS queries.
• Configurable DNS Servers: Allows you to select configurable DNS servers.
• Clean Output Format: Provides clean and concise output formats.

📦 Installation

Prerequisites

• Python 3.9 or higher
• uv (Python package manager)

Steps

1. Clone the repository.
2. Install dependencies using uv:

uv pip install -e .

💻 Usage Examples

Starting the Server

uv run ns-lookup-mcp

Debugging Mode

npx @modelcontextprotocol/inspector uv run ns-lookup-mcp 

MCP Interface

Toolset

The server provides the following tool:

{
  "name": "nslookup",
  "description": "Use the nslookup command to perform DNS queries. Supports both forward and reverse DNS queries.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "hostname": {
        "type": "string",
        "description": "The domain name or IP address to query"
      },
      "server": {
        "type": "string",
        "description": "Optional DNS server for resolution"
      }
    },
    "required": ["hostname"]
  }
}

Hints

The server provides the following hints:

{
  "name": "nslookup",
  "description": "Perform DNS queries using nslookup",
  "arguments": [
    {
      "name": "hostname",
      "description": "The domain name or IP address to query",
      "required": true
    },
    {
      "name": "server", 
      "description": "Optional DNS server",
      "required": false
    }
  ]
}

MCP Client Configuration

To use this server with an MCP client, add the following configuration to your client settings:

{
  "mcpServers": {
    "nslookup": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "[workspace]/ns-lookup-mcp", 
        "ns-lookup-mcp"
      ]
    }
  }
}

Replace [workspace] with your actual workspace path.

Example Output

The server returns DNS query results in a clean and 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

This project is licensed under the MIT license.