Ns Lookup MCP

🚀 NSLOOKUP サーバー MCP サービス

このサービスは、簡単な MCP（モデルコンテキストプロトコル）サーバーで、nslookup コマンドの機能を REST API 経由で提供します。これにより、アプリケーションに DNS 解析機能を簡単に統合できます。

🚀 クイックスタート

このサービスを使用することで、アプリケーションに 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 ライセンスの下で公開されています。