NetBox MCP Server

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.