NetBox の読み込みと書き込み機能を備えた初のモデルコンテキストプロトコル (MCP) サーバー。

既存の読み取り専用NetBox MCP実装とは異なり、このサーバーは、包括的なCRUD(作成、読み取り、更新、削除)操作を提供し、NetBoxデータをクエリするだけでなく、MCPをサポートするLMを介して直接変更することもできます。

このスペシャルを作るもの

• 最初の読み書きNetBox MCP: MCP サーバのみで、読み書きから NetBox への書き込みが可能
• 完全なCRUD操作:任意のNetBoxオブジェクトタイプを作成、読み取り、更新、削除
• バルク操作: 複数のオブジェクトを一度に効率的に処理
• 包括的なカバレッジ:すべての主要なNetBoxモデル(DCIM、IPAM、回路、仮想化など)をサポート
• 生産準備:適切なエラー処理、検証、セキュリティ慣行で構築

##特徴

読書操作

• NetBox オブジェクトタイプのリストとフィルタリング
• 特定のオブジェクトに関する詳細情報を入手
• アクセス変更履歴と監査証跡
• 高度なフィルタリングと検索機能

操作を書く

• 新しいデバイス、IPアドレス、サイト、ラックなどを作成します。
• 既存のオブジェクトプロパティを更新する

NetBox MCP Server - Read & Write Edition

The first Model Context Protocol (MCP) server with full read AND write capabilities for NetBox.

Unlike existing read-only NetBox MCP implementations, this server provides comprehensive CRUD (Create, Read, Update, Delete) operations, enabling you to not only query your NetBox data but also modify it directly through LLMs that support MCP.

What Makes This Special

• First Read-Write NetBox MCP: The only MCP server that allows both reading from AND writing to NetBox
• Full CRUD Operations: Create, read, update, and delete any NetBox object type
• Bulk Operations: Efficiently handle multiple objects at once
• Comprehensive Coverage: Supports all major NetBox models (DCIM, IPAM, Circuits, Virtualization, etc.)
• Production Ready: Built with proper error handling, validation, and security practices

Features

Read Operations

• List and filter any NetBox object type
• Get detailed information about specific objects
• Access change history and audit trails
• Advanced filtering and search capabilities

Write Operations

• Create new devices, IP addresses, sites, racks, and more
• Update existing object properties
• Delete objects (with proper safeguards)
• Bulk create, update, and delete operations

Supported Object Types

DCIM (Device and Infrastructure):

• devices, device-types, device-roles, manufacturers
• sites, locations, racks, rack-roles
• cables, interfaces, power-ports, console-ports
• platforms, regions, virtual-chassis

IPAM (IP Address Management):

• ip-addresses, prefixes, vlans, vrfs
• asns, aggregates, services
• roles, rirs, route-targets

Circuits:

• circuits, circuit-types, providers
• circuit-terminations, provider-networks

Virtualization:

• virtual-machines, clusters, cluster-groups
• cluster-types, vm-interfaces

And many more…

Installation

1. Clone this repository:

git clone https://github.com/alexkiwi1/netbox-mcp-rw.git
cd netbox-mcp-rw

2. Install dependencies:

# Using UV (recommended)
uv sync

# Or using pip
pip install -e .

3. Set environment variables:

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

4. Test the server:

NETBOX_URL=https://netbox.example.com/ NETBOX_TOKEN= uv run server.py

MCP Client Configuration

Claude Desktop (Mac/Windows)

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "netbox-rw": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/netbox-mcp-rw",
        "run",
        "server.py"
      ],
      "env": {
        "NETBOX_URL": "https://your-netbox-instance.com/",
        "NETBOX_TOKEN": "your-api-token"
      }
    }
  }
}

Other MCP Clients

This server works with any MCP-compatible client. Adjust the command and arguments based on your client’s requirements.

Usage Examples

Reading Data