netbox-mcp-server

netbox-mcp-server

0
research_and_data

The NetBox MCP Server is a Model Context Protocol server that interfaces with NetBox to provide network infrastructure data to MCP-compatible language models like Claude. It allows querying network information, device configurations, virtualization clusters, and more, leveraging tools and functions for detailed analysis.

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.

Overview

This server provides a bridge between NetBox and MCP-compatible LLMs like Claude, allowing you to:

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

Requirements

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

Available Features

Tools

The server provides these tools:

  • get_all_clusters - Get list of all clusters with key information
  • get_cluster_virtual_machines - Get all VMs in a specific cluster
  • get_cluster_interfaces - Get all interfaces from all VMs in a cluster

Example Queries for Claude

Once the server is connected to Claude Desktop, you can ask questions like:

  • "Show me a list of all clusters in our NetBox instance"
  • "Show me all the virtual machines in our primary cluster"

License

This project is licensed under the MIT License - see the LICENSE file for details.