Dns MCP Server

🚀 @cenemiljezweb/dns-mcp-server

このサーバーは、TypeScriptで構築されたModel Context Protocol (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

IPアドレスからホスト名を検索する逆DNSルックアップを実行します。

パラメーター:

• 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の型チェックを実行

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

MIT

👥 作者

MCP DNS Server Contributors

🛠️ サポート

問題や機能リクエストについては、GitHubリポジトリをご覧ください。