Ns Lookup MCP

🚀 NSLOOKUP 服务器 MCP 服务

NSLOOKUP 服务器 MCP 服务是一个简单的 MCP（模型上下文协议）服务器，它将 nslookup 命令的功能以 REST API 的形式暴露出来。借助该服务，你可以通过 REST API 实现 DNS 查询功能，轻松为应用集成 DNS 解析能力。

🚀 快速开始

NSLOOKUP 服务器 MCP 服务能让你在应用中便捷地使用 DNS 解析功能。下面为你介绍如何快速开启使用之旅。

✨ 主要特性

• REST API 接口：暴露 nslookup 命令的 REST API 接口，方便调用。
• 微服务架构：简单且专注的微服务，易于集成和维护。
• 现代 Python 工具：使用现代 Python 工具（uv 和 pyproject.toml），紧跟技术潮流。
• 双向 DNS 查询：支持正向和反向 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": "使用 nslookup 命令执行 DNS 查询。支持正向和反向 DNS 查询。",
  "inputSchema": {
    "type": "object",
    "properties": {
      "hostname": {
        "type": "string",
        "description": "要查询的域名或 IP 地址"
      },
      "server": {
        "type": "string",
        "description": "可选 DNS 服务器用于解析"
      }
    },
    "required": ["hostname"]
  }
}

提示

该服务器提供以下提示：

{
  "name": "nslookup",
  "description": "使用 nslookup 执行 DNS 查询",
  "arguments": [
    {
      "name": "hostname",
      "description": "要查询的域名或 IP 地址",
      "required": true
    },
    {
      "name": "server", 
      "description": "可选的 DNS 服务器",
      "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 许可证。