NetBox MCP Server

Name: NetBox MCP Server
Author: ardecode

@ardecode

Repository

About NetBox MCP Server

A MCP server for NetBox

#netbox #mcp #server #network-infrastructure

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "netbox-mcp-server-ardecode": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

Get list of all clusters with key information

Get all VMs in a specific cluster

Get all interfaces from all VMs in a cluster

Overview

What is NetBox MCP Server?

A Model Context Protocol (MCP) server that connects to NetBox and exposes network infrastructure data for use with Claude and other MCP-compatible LLMs.

How to use NetBox MCP Server?

Install Python 3.10+, the httpx and mcp packages, then run the server with python netbox_server.py --url <NetBox URL> --token <API token>. Environment variables NETBOX_URL and NETBOX_TOKEN can also be used. For Claude Desktop, add the server configuration to claude_desktop_config.json.

Key features of NetBox MCP Server

Queries and analyzes network infrastructure data from NetBox
Checks device configurations and connections
Examines virtualization clusters and virtual machines
Analyzes VLANs, IP address allocations, and more
Generates network topology information
Detects NVMe storage in clusters

Use cases of NetBox MCP Server

Ask an LLM for a list of all clusters in your NetBox instance
Retrieve all virtual machines in a specific cluster
Examine interfaces across all VMs in a cluster
Analyze IP address allocations and VLAN configurations
Generate network topology from stored infrastructure data

FAQ from NetBox MCP Server

What dependencies are required?

Python 3.10 or higher, a NetBox instance with API access, a NetBox API token (read permissions), and the httpx and mcp Python packages.

How is the server configured?

Pass the NetBox URL and API token as command-line arguments (--url and --token) or set the NETBOX_URL and NETBOX_TOKEN environment variables.

What transports does the server use?

The README does not specify transport details. It communicates via the MCP protocol using the mcp Python SDK.

Can I use this server with Claude Desktop?

Yes. Add the server configuration to claude_desktop_config.json under mcpServers with the command python and arguments pointing to the server script, URL, and token.

What data does the server expose?

It exposes tools that query clusters, virtual machines, interfaces, devices, VLANs, IP allocations, and more from your NetBox instance. All data stays within your NetBox and is accessed via its API.