Netbox MCP Server 1is

🚀 NetBox MCP 服務器

NetBox MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它能夠連接到 NetBox，為 Claude 等與 MCP 兼容的大語言模型（LLM）提供網絡基礎設施數據。藉助該服務器，用戶可便捷地查詢、分析網絡基礎架構數據，查看設備配置與連接情況等。

🚀 快速開始

此服務器作為 NetBox 和 MCP 兼容的 LLM（如 Claude）之間的橋樑，為您提供了強大的網絡基礎設施數據查詢和分析能力。您可以使用它來執行以下操作：

• 查詢和分析您的網絡基礎架構數據
• 檢查設備配置和連接
• 查看虛擬化集群和虛擬機
• 分析 VLAN、IP 地址分配等
• 生成網絡拓撲信息
• 檢測集群中的 NVMe 存儲

服務器還提供了執行操作的工具功能。

✨ 主要特性

• 充當 NetBox 和 MCP 兼容的 LLM 之間的橋樑，實現數據交互。
• 提供多種網絡基礎設施數據的查詢和分析功能。
• 支持與 Claude Desktop 集成，方便使用。

📦 安裝指南

使用 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 3.10 或更高版本
• 帶有 API 訪問權限的 NetBox 實例
• 具有讀取權限的 NetBox API 令牌
• httpx 庫用於 HTTP 請求
• mcp Python SDK 用於 Model Context Protocol

💻 使用示例

直接運行服務器

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. 將 NetBox 服務器配置添加到 claude_desktop_config.json：

{
  "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 - 獲取集群中所有虛擬機的所有接口