NetBox Read/Write MCP Server

A Model Context Protocol (MCP) server that provides safe, intelligent read/write access to NetBox instances. Designed with safety-first principles for Large Language Model automation.

🎯 Project Vision

Create a robust bridge between LLMs and NetBox that enables:

Safe Write Operations: All mutations require explicit confirmation
Idempotent Operations: Consistent results regardless of call frequency
Integration Ready: Designed for Unimus network discovery workflows
Enterprise Grade: Production-ready with comprehensive safety mechanisms

🚧 Development Status

Current Version: v0.1.0-dev (Phase 1: Foundation & Read-Only Core)

This project is under active development. See GitHub Issues for current roadmap and progress.

📋 Roadmap

Development follows a phased approach with safety-first principles:

v0.1 - Foundation & Read-Only Core (current)
v0.2 - Initial Write Capabilities & Safety
v0.3 - Advanced R/W Operations & Relations
v0.4 - Enterprise Features & Integration-readiness
v1.0 - Production-readiness & Full Integration

🔧 Development Setup

Prerequisites

Python 3.9+
Access to a NetBox instance (Cloud or self-hosted)
NetBox API token with appropriate permissions

Installation

# Clone the repository
git clone https://github.com/Deployment-Team/netbox-mcp.git
cd netbox-mcp

# Install in development mode
pip install -e .

# Install development dependencies
pip install -e ".[dev]"

Configuration

Copy the example environment file and configure your NetBox instance:

cp .env.example .env
# Edit .env with your NetBox URL and API token

🏗️ Architecture

The server follows a modular design:

netbox_mcp.client: NetBox API client with safety mechanisms
netbox_mcp.server: MCP server with tool definitions
netbox_mcp.config: Configuration management
Safety Layer: Confirmation parameters and dry-run mode throughout

🔒 Safety Features

CRITICAL: This server can perform write operations on NetBox data.

Built-in Safety Mechanisms:

Confirmation Required: All write operations require confirm=True
Dry-Run Mode: Global NETBOX_DRY_RUN=true prevents actual writes
Comprehensive Logging: All mutations logged with detailed context
Idempotent Design: Safe to retry operations
Error Handling: Graceful failure with clear error messages

📊 Current Implementation Status

✅ Completed:

Project structure and dependencies
Exception handling framework
Configuration foundation

🚧 In Progress:

NetBox API client (read-only)
Basic MCP server implementation

📅 Upcoming:

Write operations with safety controls
Idempotent ensure methods
Docker containerization

🤝 Contributing

This project is under active development. See our GitHub Issues for:

Current development priorities
Feature requests and roadmap
Bug reports and discussions

📄 License

MIT License - see LICENSE file for details.

Unimus MCP - Read-only MCP for Unimus network management
NetBox - The network documentation and IPAM application

⚠️ Development Notice: This is a development version with write capabilities. Always use proper safety measures and test in non-production environments.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that provides safe, intelligent read/write access to NetBox instances, designed with safety-first principles for Large Language Model automation.

Related MCP Servers

n8n MCP Server
illuminaresolutions
A
security
A
license
A
quality
An MCP server enabling secure interaction with n8n workflows, executions, and settings via the Model Context Protocol, designed for integration with Large Language Models (LLMs).
Last updated -
33
65
34
TypeScript
MIT License
mcp-server-code-assist
abhishekbhakat
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.
Last updated -
12
Python
MIT License
MCP Filesystem Server
safurrier
-
security
A
license
-
quality
A Model Context Protocol server that provides secure and intelligent interaction with files and filesystems, offering smart context management and token-efficient operations for working with large files and complex directory structures.
Last updated -
5
Python
MIT License
Windows Command Line MCP Server
alxspiker
A
security
A
license
A
quality
A secure Model Context Protocol server that allows AI models to safely interact with Windows command-line functionality, enabling controlled execution of system commands, project creation, and system information retrieval.
Last updated -
8
3
TypeScript
MIT License

View all related MCP servers

NetBox Read/Write MCP Server