Netbox MCP Server 1is

🚀 NetBox MCP Server

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

🚀 Quick Start

This server acts as a bridge between NetBox and MCP-compatible LLMs (such as Claude), enabling you to:

• Query and analyze your network infrastructure data
• Check device configurations and connections
• View virtualization clusters and virtual machines
• Analyze VLANs, IP address allocations, etc.
• Generate network topology information
• Detect NVMe storage in clusters

The server offers the following:

• Tools: Functions to perform operations

✨ Features

Tools

The server provides the following tools:

• get_all_clusters - Get a list of all clusters and their key information
• get_cluster_virtual_machines - Get all virtual machines in a specific cluster
• get_cluster_interfaces - Get all interfaces of all virtual machines in a cluster

📦 Installation

Using uv (Recommended)

# Create a virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install the required packages
uv add mcp httpx

Using pip

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the required packages
pip install mcp httpx

💻 Usage Examples

Running the Server Directly

python netbox_server.py --url https://your-netbox-instance.example.com --token your-api-token

You can also set environment variables instead of using command-line arguments:

export NETBOX_URL="https://your-netbox-instance.example.com"
export NETBOX_TOKEN="your-api-token"
python netbox_server.py

Integrating with Claude Desktop

To integrate with Claude Desktop:

1. Install Claude Desktop from https://claude.ai/download.
2. Open the Claude menu and select "Settings...".
3. Click "Developer" in the left sidebar.
4. Click "Edit Configuration".
5. Add the NetBox server configuration to 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. Save the file and restart Claude Desktop.

🔧 Technical Details

Requirements

• Python 3.10 or higher
• A NetBox instance with API access
• A NetBox API token with read permissions
• The httpx library for HTTP requests
• The mcp Python SDK for the Model Context Protocol