Dns MCP Server

🚀 @cenemiljezweb/dns-mcp-server

這是一個基於TypeScript的模型上下文協議（MCP）服務器，為AI助手提供全面的DNS查詢功能。

🚀 快速開始

與Claude Desktop配合使用

將以下配置添加到Claude Desktop的配置文件中（在macOS上為 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "dns-server": {
      "command": "npx",
      "args": ["@cenemiljezweb/dns-mcp-server"],
      "env": {}
    }
  }
}

或者，如果你已經全局安裝了該服務器，可以使用以下配置：

{
  "mcpServers": {
    "dns-server": {
      "command": "mcp-dns-server",
      "args": [],
      "env": {}
    }
  }
}

✨ 主要特性

• 多種DNS記錄類型：支持A、AAAA、CNAME、MX、TXT、NS、SOA、PTR、SRV和CAA記錄。
• 反向DNS查詢：將IP地址轉換回主機名。
• 批量查詢：並行或順序執行多個DNS查詢。
• DNS追蹤：追蹤從根服務器到最終結果的DNS解析路徑。
• 可配置的DNS服務器：使用自定義的DNS服務器（如Google、Cloudflare或你自己的服務器）。
• 日誌記錄：提供全面的日誌記錄，且日誌級別可配置。
• 錯誤處理：強大的錯誤處理機制，提供詳細的錯誤信息。

📦 安裝指南

通過NPM全局安裝

npm install -g @cenemiljezweb/dns-mcp-server

使用NPX（無需安裝）

npx @cenemiljezweb/dns-mcp-server

💻 使用示例

配置文件示例

服務器可以通過工作目錄中的 dns-config.json 文件進行配置：

{
  "dns": {
    "servers": ["8.8.8.8", "8.8.4.4", "1.1.1.1", "1.0.0.1"],
    "timeout": 5000,
    "retries": 2,
    "useTCP": false
  },
  "cache": {
    "enabled": true,
    "ttl": 300,
    "maxSize": 1000
  },
  "logging": {
    "level": "info",
    "file": "dns-server.log"
  }
}

MCP工具使用示例

1. dns_lookup

執行DNS查詢以獲取各種記錄類型。

參數：

• domain（必填）：要查詢的域名。
• recordType：DNS記錄類型（A、AAAA、CNAME、MX、TXT、NS、SOA、PTR、SRV、CAA）。
• useCustomServer：如果已配置，使用自定義的DNS服務器。
• timeout：查詢超時時間（毫秒）。

示例：

{
  "domain": "example.com",
  "recordType": "A"
}

2. reverse_dns

執行反向DNS查詢，以查找IP地址對應的主機名。

參數：

• ipAddress（必填）：要進行反向查詢的IP地址。
• timeout：查詢超時時間（毫秒）。

示例：

{
  "ipAddress": "8.8.8.8"
}

3. batch_dns

在一次操作中執行多個DNS查詢。

參數：

• queries（必填）：要執行的DNS查詢數組。
  • domain：域名。
  • recordTypes：要查詢的記錄類型數組。
• parallel：並行執行查詢（默認值：true）。
• timeout：每個請求的查詢超時時間。

示例：

{
  "queries": [
    {"domain": "example.com", "recordTypes": ["A", "MX"]},
    {"domain": "google.com", "recordTypes": ["A", "AAAA"]}
  ],
  "parallel": true
}

4. dns_trace

追蹤從根服務器到最終結果的DNS解析路徑。

參數：

• domain（必填）：要追蹤DNS解析路徑的域名。
• recordType：要追蹤的記錄類型（默認值：A）。

示例：

{
  "domain": "example.com",
  "recordType": "A"
}

📚 詳細文檔

開發相關

本地開發

# 克隆倉庫
git clone https://github.com/yourusername/mcp-dns-server.git
cd mcp-dns-server

# 安裝依賴
npm install

# 以開發模式運行
npm run dev

# 構建項目
npm run build

# 運行測試
npm test

腳本說明

• npm run build - 將TypeScript編譯為JavaScript。
• npm run dev - 以熱重載模式在開發環境中運行。
• npm start - 運行編譯後的服務器。
• npm test - 運行單元測試。
• npm run lint - 運行ESLint代碼檢查。
• npm run typecheck - 運行TypeScript類型檢查。

貢獻代碼

歡迎貢獻代碼！請隨時提交Pull Request。

📄 許可證

本項目採用MIT許可證。

作者

MCP DNS Server貢獻者

支持

如有問題或功能請求，請訪問GitHub倉庫。