Ns Lookup MCP

🚀 NSLOOKUP 服務器 MCP 服務

NSLOOKUP 服務器 MCP 服務是一個簡單的 MCP（模型上下文協議）服務器，它將 nslookup 命令的功能通過 REST API 暴露出來，讓你能在應用中輕鬆集成 DNS 解析能力。

✨ 主要特性

• 🌐 提供暴露 nslookup 命令的 REST API 接口。
• 🧐 是簡單且專注的微服務。
• 🛠️ 使用現代 Python 工具（uv 和 pyproject.toml）。
• ➡️⬅️ 支持正向和反向 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 許可證。