MCP 服务器

NetBox MCP Server

为 NetBox 提供的 MCP 服务器 (Wèi NetBox tígōng de MCP fúwùqì)

ardecode

开发者工具

访问服务器

README

NetBox MCP 服务器

一个模型上下文协议 (MCP) 服务器，连接到 NetBox 并公开网络基础设施数据，以便与 Claude 和其他 MCP 兼容的 LLM 一起使用。

概述

此服务器提供 NetBox 和 MCP 兼容的 LLM（如 Claude）之间的桥梁，允许您：

查询和分析您的网络基础设施数据
检查设备配置和连接
检查虚拟化集群和虚拟机
分析 VLAN、IP 地址分配等
生成网络拓扑信息
检测集群中的 NVMe 存储

服务器公开：

工具: 执行操作的函数

要求

Python 3.10 或更高版本
具有 API 访问权限的 NetBox 实例
具有读取权限的 NetBox API 令牌
用于 HTTP 请求的 httpx 库
用于模型上下文协议的 mcp Python SDK

安装

使用 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 集成：

从 https://claude.ai/download 安装 Claude Desktop
打开 Claude 菜单并选择“Settings...”
单击左侧边栏中的“Developer”
单击“Edit Config”
将 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"
      ]
    }
  }
}

保存文件并重新启动 Claude Desktop

可用功能

工具

服务器提供以下工具：

get_all_clusters - 获取包含关键信息的所有集群的列表
get_cluster_virtual_machines - 获取特定集群中的所有 VM
get_cluster_interfaces - 获取集群中所有 VM 的所有接口

Claude 的示例查询

将服务器连接到 Claude Desktop 后，您可以提出如下问题：

“Show me a list of all clusters in our NetBox instance”（显示我们 NetBox 实例中的所有集群的列表）
“Show me all the virtual machines in our primary cluster”（显示我们主集群中的所有虚拟机）