NetBox MCP Server

Name: NetBox MCP Server
Author: ardecode

@ardecode

代码仓库

关于 NetBox MCP Server

A MCP server for NetBox

#netbox #mcp #server #network-infrastructure

基本信息

分类

其他

许可证

MIT license

运行时

python

传输方式

stdio

发布者

ardecode

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

Get list of all clusters with key information

Get all VMs in a specific cluster

Get all interfaces from all VMs in a cluster

概览

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.