Netbox MCP Server 1is

🚀 NetBox MCP サーバ

NetBox に接続し、Claude やその他の MCP 互換の大規模言語モデル（LLM）にネットワークインフラストラクチャデータを提供する Model Context Protocol (MCP) サーバです。このサーバを使用することで、ネットワークインフラストラクチャデータのクエリや分析、デバイス構成や接続の確認、仮想化クラスタや仮想マシンの表示、VLAN や IP アドレス割り当ての分析、ネットワークトポロジ情報の生成、クラスタ内の NVMe ストレージの検出などの操作が可能になります。

🚀 クイックスタート

このサーバは、NetBox と MCP 互換の LLM（Claude など）の間の橋渡しとして機能します。以下のことができます：

• ネットワークインフラストラクチャデータのクエリと分析
• デバイス構成と接続の確認
• 仮想化クラスタと仮想マシンの表示
• VLAN、IP アドレス割り当てなどの分析
• ネットワークトポロジ情報の生成
• クラスタ内の NVMe ストレージの検出

サーバは以下を提供します：

• ツール：操作を実行する機能

✨ 主な機能

• ネットワークインフラストラクチャデータのクエリと分析
• デバイス構成と接続の確認
• 仮想化クラスタと仮想マシンの表示
• VLAN、IP アドレス割り当てなどの分析
• ネットワークトポロジ情報の生成
• クラスタ内の NVMe ストレージの検出

📦 インストール

uv を使用する（推奨）

# 仮想環境の作成
uv venv
source .venv/bin/activate  # Windows の場合：.venv\Scripts\activate

# 必要なパッケージのインストール
uv add mcp httpx

pip を使用する

# 仮想環境の作成
python -m venv venv
source venv/bin/activate  # Windows の場合：venv\Scripts\activate

# 必要なパッケージのインストール
pip install mcp httpx

💻 使用例

サーバを直接実行する

python netbox_server.py --url https://your-netbox-instance.example.com --token your-api-token

コマンドライン引数の代わりに環境変数を設定することもできます：

export NETBOX_URL="https://your-netbox-instance.example.com"
export NETBOX_TOKEN="your-api-token"
python netbox_server.py

Claude Desktop との統合

Claude Desktop と統合するには：

1. https://claude.ai/download から Claude Desktop をインストールします。
2. Claude メニューを開き、「設定...」を選択します。
3. 左側のサイドバーで「開発者」をクリックします。
4. 「設定の編集」をクリックします。
5. claude_desktop_config.json に NetBox サーバの設定を追加します：

{
  "mcpServers": {
    "netbox": {
      "command": "python",
      "args": [
        "/path/to/netbox_server.py",
        "--url",
        "https://your-netbox-instance.example.com",
        "--token",
        "your-api-token"
      ]
    }
  }
}

6. ファイルを保存し、Claude Desktop を再起動します。

利用可能な機能

ツール

このサーバは以下のツールを提供します：

• get_all_clusters - すべてのクラスタのリストと重要な情報を取得する
• get_cluster_virtual_machines - 特定のクラスタ内のすべての仮想マシンを取得する
• get_cluster_interfaces - クラスタ内のすべての仮想マシンのすべてのインターフェイスを取得する