NS Lookup MCP Server

NS Lookup MCP 服务

一个简单的 MCP（Model Context Protocol）服务，用于提供 nslookup 命令功能。该服务提供 REST API 接口来执行 DNS 查询，便于将 DNS 解析功能集成到应用程序中。

功能

• 通过 REST API 提供 nslookup 命令功能
• 简单且专注的微服务
• 使用 uv 和 pyproject.toml 的现代 Python 工具
• 支持正向和反向 DNS 查询
• 可配置 DNS 服务器
• 输出格式简洁明了

要求

• Python 3.9 或更高版本
• uv（Python 包管理器）

安装

1. 克隆仓库
2. 使用 uv 安装依赖：

uv pip install -e .

用法

启动服务：

uv run ns-lookup-mcp

调试模式：

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

MCP 接口

工具

该服务提供以下工具：

{
  "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"]
  }
}

提示词

该服务提供以下提示词：

{
  "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 客户端配置

要将此服务与 MCP 客户端配合使用，请在客户端的设置中添加以下配置：

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

将 [workspace] 替换为工作区目录的实际路径。

输出示例

该服务以简洁明了的格式返回 DNS 查询结果：

DNS:    192.168.1.1
Name:   example.com
Address: 93.184.216.34

常见 DNS 服务器

• Google DNS：8.8.8.8
• Cloudflare DNS：1.1.1.1
• OpenDNS：208.67.222.222

许可证

MIT