原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。评价和账户功能将在后续阶段推出。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

NetBox MCP

作者:mhajder版本 0.3.0i★ –i在你的电脑上运行
注册名称io.github.mhajder/netbox-mcp

安装

概览

作者提供的说明(英文原文)

MCP server for NetBox DCIM/IPAM with read-only and dry-run modes

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

  • 连接方式: 在你的电脑上运行
  • 传输方式: stdio, Streamable HTTP
  • 分类: 其他
  • 你需要填写:NETBOX_URL, NETBOX_TOKEN

安装

选择你使用的 AI 应用,然后复制设置。

安装之前

  • 基础检查:1 项中通过 1 项
  • 在你的电脑上运行,拥有你的用户账户的权限(文件、网络、应用)。
  • 需要你自己填写: NETBOX_URL, NETBOX_TOKEN, NETBOX_VERIFY_SSL, NETBOX_TIMEOUT, NETBOX_BRANCHING_ENABLED, NETBOX_BRANCH, NETBOX_PLUGIN_DISCOVERY, READ_ONLY_MODE, DRY_RUN_MODE, DISABLED_TAGS, LOG_LEVEL, RESPONSE_MAX_SIZE, RATE_LIMIT_ENABLED, RATE_LIMIT_MAX_REQUESTS, RATE_LIMIT_WINDOW_MINUTES, TOOL_SEARCH_ENABLED, TOOL_SEARCH_STRATEGY, TOOL_SEARCH_MAX_RESULTS

标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。

你需要

  • PyPI已安装 Python 的 uv(用于 uvx 命令)

你用的是哪个应用?

在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "netbox": {
      "command": "uvx",
      "args": [
        "netbox-mcp"
      ],
      "env": {
        "NETBOX_URL": "your-value",
        "NETBOX_TOKEN": "your-value",
        "NETBOX_VERIFY_SSL": "your-value",
        "NETBOX_TIMEOUT": "your-value",
        "NETBOX_BRANCHING_ENABLED": "your-value",
        "NETBOX_BRANCH": "your-value",
        "NETBOX_PLUGIN_DISCOVERY": "your-value",
        "READ_ONLY_MODE": "your-value",
        "DRY_RUN_MODE": "your-value",
        "DISABLED_TAGS": "your-value",
        "LOG_LEVEL": "your-value",
        "RESPONSE_MAX_SIZE": "your-value",
        "RATE_LIMIT_ENABLED": "your-value",
        "RATE_LIMIT_MAX_REQUESTS": "your-value",
        "RATE_LIMIT_WINDOW_MINUTES": "your-value",
        "TOOL_SEARCH_ENABLED": "your-value",
        "TOOL_SEARCH_STRATEGY": "your-value",
        "TOOL_SEARCH_MAX_RESULTS": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add netbox --env NETBOX_URL=your-value --env NETBOX_TOKEN=your-value --env NETBOX_VERIFY_SSL=your-value --env NETBOX_TIMEOUT=your-value --env NETBOX_BRANCHING_ENABLED=your-value --env NETBOX_BRANCH=your-value --env NETBOX_PLUGIN_DISCOVERY=your-value --env READ_ONLY_MODE=your-value --env DRY_RUN_MODE=your-value --env DISABLED_TAGS=your-value --env LOG_LEVEL=your-value --env RESPONSE_MAX_SIZE=your-value --env RATE_LIMIT_ENABLED=your-value --env RATE_LIMIT_MAX_REQUESTS=your-value --env RATE_LIMIT_WINDOW_MINUTES=your-value --env TOOL_SEARCH_ENABLED=your-value --env TOOL_SEARCH_STRATEGY=your-value --env TOOL_SEARCH_MAX_RESULTS=your-value -- uvx netbox-mcp

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "netbox": {
      "command": "uvx",
      "args": [
        "netbox-mcp"
      ],
      "env": {
        "NETBOX_URL": "your-value",
        "NETBOX_TOKEN": "your-value",
        "NETBOX_VERIFY_SSL": "your-value",
        "NETBOX_TIMEOUT": "your-value",
        "NETBOX_BRANCHING_ENABLED": "your-value",
        "NETBOX_BRANCH": "your-value",
        "NETBOX_PLUGIN_DISCOVERY": "your-value",
        "READ_ONLY_MODE": "your-value",
        "DRY_RUN_MODE": "your-value",
        "DISABLED_TAGS": "your-value",
        "LOG_LEVEL": "your-value",
        "RESPONSE_MAX_SIZE": "your-value",
        "RATE_LIMIT_ENABLED": "your-value",
        "RATE_LIMIT_MAX_REQUESTS": "your-value",
        "RATE_LIMIT_WINDOW_MINUTES": "your-value",
        "TOOL_SEARCH_ENABLED": "your-value",
        "TOOL_SEARCH_STRATEGY": "your-value",
        "TOOL_SEARCH_MAX_RESULTS": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "netbox": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "netbox-mcp"
      ],
      "env": {
        "NETBOX_URL": "your-value",
        "NETBOX_TOKEN": "your-value",
        "NETBOX_VERIFY_SSL": "your-value",
        "NETBOX_TIMEOUT": "your-value",
        "NETBOX_BRANCHING_ENABLED": "your-value",
        "NETBOX_BRANCH": "your-value",
        "NETBOX_PLUGIN_DISCOVERY": "your-value",
        "READ_ONLY_MODE": "your-value",
        "DRY_RUN_MODE": "your-value",
        "DISABLED_TAGS": "your-value",
        "LOG_LEVEL": "your-value",
        "RESPONSE_MAX_SIZE": "your-value",
        "RATE_LIMIT_ENABLED": "your-value",
        "RATE_LIMIT_MAX_REQUESTS": "your-value",
        "RATE_LIMIT_WINDOW_MINUTES": "your-value",
        "TOOL_SEARCH_ENABLED": "your-value",
        "TOOL_SEARCH_STRATEGY": "your-value",
        "TOOL_SEARCH_MAX_RESULTS": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

这个服务器在你的电脑上运行,而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上,无需账户。

需要你填写的值

  • NETBOX_URL 必填 env
    NetBox base URL (e.g., https://netbox.example.com)
  • NETBOX_TOKEN 机密 必填 env
    NetBox API token: v2 (nbt_ . , NetBox 4.5+) or legacy v1
  • NETBOX_VERIFY_SSL env
    Verify SSL certificates (true/false)
  • NETBOX_TIMEOUT env
    Total time allowed for one NetBox request, retries included (seconds)
  • NETBOX_BRANCHING_ENABLED env
    Enable netbox-branching support: branch tools and the 'branch' argument (requires the netbox-branching plugin) (true/false)
  • NETBOX_BRANCH env
    Default netbox-branching branch (name or schema ID) for every call; requires NETBOX_BRANCHING_ENABLED=true
  • NETBOX_PLUGIN_DISCOVERY env
    Discover plugin object types from /api/core/object-types/ (true/false)
  • READ_ONLY_MODE env
    Hide all write tools (create, update, delete) (true/false)
  • DRY_RUN_MODE env
    Write tools only simulate changes and never modify NetBox (true/false)
  • DISABLED_TAGS env
    Comma-separated tool tags to disable (e.g. delete,graphql,branching)
  • LOG_LEVEL env
    Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
  • RESPONSE_MAX_SIZE env
    Maximum tool response size in bytes (unset = unlimited)
  • RATE_LIMIT_ENABLED env
    Enable rate limiting
  • RATE_LIMIT_MAX_REQUESTS env
    Maximum requests per rate limit window
  • RATE_LIMIT_WINDOW_MINUTES env
    Rate limit window in minutes
  • TOOL_SEARCH_ENABLED env
    Enable FastMCP tool search transform
  • TOOL_SEARCH_STRATEGY env
    Tool search strategy (bm25 or regex)
  • TOOL_SEARCH_MAX_RESULTS env
    Maximum tool search results returned by search_tools

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

它能做什么

它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 mhajder 验证,该账户拥有此仓库

  • … 尚未检查

    仍在维护

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • – 不适用

    端点有响应

    它在你的电脑上运行,没有互联网端点

  • – 不适用

    使用 OAuth 登录

    在你的电脑上运行,改用本地设置

  • … 尚未检查

    工具描述中没有隐藏指令

    它在你的电脑上运行;我们只能读取互联网端点的工具列表

与“其他”中的其他服务器比较i

  • 星标数多于此分类中其他 18336 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 18336 个服务器的 100% 更新
  • 基础检查结果等于或优于此分类中其他 18336 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

NetBox MCP 安全吗?

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

你需要填写:NETBOX_URL, NETBOX_TOKEN

它在我的电脑上运行还是在云端?

它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。

它还在维护吗?

GitHub 仓库最后更新于–,最新版本(0.3.0)于今天进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv), Docker。

有什么可以替代它?

同一分类中有:Spec Driven Development, Remote Desktop Commander, NexusWindows

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spec Driven Development

作者:formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

在你的电脑上运行★ 440MIT14个月前更新
安装

Remote Desktop Commander

作者:desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

在云端运行★ 211前天更新
安装

NexusWindows

作者:pironjulien

Windows computer use in the background: desktop apps driven without your mouse or keyboard.

在你的电脑上运行今天更新
安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

NetBox MCP Server

Give AI agents structured access to NetBox, your network source of truth

Installation · Tools · Configuration · Security

NetBox MCP Server is a Python-based Model Context Protocol (MCP) server that gives AI assistants structured access to NetBox - the source of truth for network infrastructure (DCIM and IPAM). A small set of generic tools covers all 139 core object types of NetBox 4.7 (and plugin types, if enabled), plus specialised tools for search, change logs, GraphQL, free IP/prefix/VLAN allocation, prefix utilization, free rack space, cable tracing and connecting, config rendering, custom scripts and (optionally) netbox-branching. Writes can be hidden entirely (read-only mode) or simulated (dry-run mode).

✨ Features

Core Features
  • Query any NetBox object type with filtering, ordering and pagination through one tool
  • Keep responses small with fields, omit and brief - the tools steer the model to use them
  • Search many object types at once, with explicit reporting of failed and truncated types
  • Read the change log (who changed what, when) and NetBox status/version/plugins
  • Run read-only GraphQL queries for nested data in one round trip
  • List free IPs, prefixes, VLANs and ASNs; trace cable paths; render device configs
  • Compute prefix utilization (as the NetBox UI shows it) and find racks with room for a device
Management Operations
  • Create, update and delete any object type, singly or in bulk (NetBox runs a bulk write as one transaction)
  • Allocate the next free IP, prefix, VLAN or ASN atomically
  • Connect ports with a cable, naming them by device and port name
  • Run NetBox custom scripts (changes rolled back unless commit is set)
  • Optionally stage changes in a netbox-branching branch instead of main
  • Describe an object type's writable fields and choices before writing
Advanced Capabilities
  • Read-only mode hides every write tool; dry-run mode turns every write into a preview
  • NetBox v2 (Bearer nbt_...) and legacy v1 (Token ...) API tokens
  • Plugin object type discovery (e.g. netbox_dns.zone)
  • Filter validation that rejects filters NetBox would silently ignore (__in, multi-hop lookups)
  • Retries on 429/5xx without ever replaying a create after a server error
  • Tag-based tool filtering, optional tool-search transform, rate limiting and response size limit
  • Bearer token authentication for HTTP transport
  • Multiple transport options (STDIO, SSE, HTTP)
  • Optional Sentry integration for error tracking

🚀 Installation

Prerequisites
  • Python 3.11 to 3.15
  • A NetBox instance, version 4.2 or newer. Features added later (omit, v2 tokens, /api/authentication-check/) are used when the server detects them
  • A NetBox API token with the permissions you want the assistant to have. The token is the real security boundary: a read-only token cannot write, whatever this server's settings are
Quick Install from PyPI

The easiest way to get started is to install from PyPI:

# Using UV (recommended)

uvx netbox-mcp

Or using pip

pip install netbox-mcp

Remember to configure the environment variables for your NetBox instance before running the server:

# Create environment configuration

export NETBOX_URL=https://netbox.example.com export NETBOX_TOKEN=nbt_your-key.your-token

Install from Source
  1. Clone the repository:
git clone https://github.com/mhajder/netbox-mcp.git

cd netbox-mcp

  1. Install dependencies:
# Using UV (recommended)

uv sync

Or using pip

pip install -e .

  1. Configure environment variables:
cp .env.example .env

Edit .env with your NetBox URL and API token

  1. Run the server:
# Using UV (recommended)

uv run netbox-mcp

Or using the installed command directly

netbox-mcp

Using Docker

A Docker image is available on GitHub Packages for easy deployment.

docker pull ghcr.io/mhajder/netbox-mcp:latest
Development Setup

For development with additional tools:

# Clone and install with development dependencies

git clone https://github.com/mhajder/netbox-mcp.git cd netbox-mcp uv sync --group dev

Run tests

uv run pytest

Run with coverage

uv run pytest --cov=src/

Run linting and formatting

uv run ruff check . uv run ruff format .

Run type checking

uv run ty check .

Setup prek hooks

uv run prek install

🔧 Configuration

Environment Variables
# NetBox MCP Server Environment Configuration

NetBox Connection Details

NETBOX_URL=https://netbox.example.com

API Token - v2 tokens (nbt_ . , NetBox 4.5+) are sent as "Bearer",

legacy v1 tokens as "Token"

NETBOX_TOKEN=nbt_your-key.your-token

SSL Configuration

NETBOX_VERIFY_SSL=true

Total time allowed for one NetBox request, retries included (seconds)

NETBOX_TIMEOUT=30

Branching (requires the netbox-branching plugin)

Set NETBOX_BRANCHING_ENABLED true to add the branch tools and the 'branch'

argument to every tool. Off by default - leave it off on a NetBox without the plugin

NETBOX_BRANCHING_ENABLED=false

Default branch (name or schema ID) used by every call; empty = main.

Requires NETBOX_BRANCHING_ENABLED=true

NETBOX_BRANCH=

Plugin Discovery

Set NETBOX_PLUGIN_DISCOVERY true to expose plugin models (e.g. netbox_dns.zone)

NETBOX_PLUGIN_DISCOVERY=false

Read-Only Mode

Set READ_ONLY_MODE true to hide all write tools (create, update, delete)

READ_ONLY_MODE=false

Dry-Run Mode

Set DRY_RUN_MODE true to make every write tool only simulate the change:

it returns the request it would send and never modifies NetBox

DRY_RUN_MODE=false

Disabled Tags

Comma-separated list of tags to disable tools for (empty by default)

Example: DISABLED_TAGS=delete,graphql,branching

DISABLED_TAGS=

Logging Configuration

LOG_LEVEL=INFO

Response Size Limit

Maximum tool response size in bytes; larger responses are truncated (empty = unlimited)

RESPONSE_MAX_SIZE=

Rate Limiting

Set RATE_LIMIT_ENABLED true to enable rate limiting

RATE_LIMIT_ENABLED=false RATE_LIMIT_MAX_REQUESTS=60 RATE_LIMIT_WINDOW_MINUTES=1

Tool Search Transform (Optional)

Set TOOL_SEARCH_ENABLED true to replace full tool listings with search_tools + call_tool

TOOL_SEARCH_ENABLED=false

Search strategy: bm25 (natural language) or regex (pattern match)

TOOL_SEARCH_STRATEGY=bm25

Maximum number of tools returned by search_tools

TOOL_SEARCH_MAX_RESULTS=5

Sentry Error Tracking (Optional)

Set SENTRY_DSN to enable error tracking and performance monitoring

SENTRY_DSN=https://your-key@o12345.ingest.us.sentry.io/6789

Optional Sentry configuration

SENTRY_TRACES_SAMPLE_RATE=1.0

SENTRY_SEND_DEFAULT_PII=false

SENTRY_ENVIRONMENT=production

SENTRY_RELEASE=1.2.3

SENTRY_PROFILE_SESSION_SAMPLE_RATE=1.0

SENTRY_PROFILE_LIFECYCLE=trace

SENTRY_ENABLE_LOGS=true

MCP Transport Configuration

Transport type: 'stdio' (default), 'sse' (Server-Sent Events), or 'http' (HTTP Streamable)

'streamable-http' is accepted as an alias for 'http'. Any other value stops

the server at startup.

MCP_TRANSPORT=stdio

HTTP Transport Settings (used when MCP_TRANSPORT=sse or MCP_TRANSPORT=http)

Host to bind the HTTP server (default: 127.0.0.1)

MCP_HTTP_HOST=127.0.0.1

Port to bind the HTTP server (default: 8000)

MCP_HTTP_PORT=8000

Optional bearer token for authentication (leave empty for no auth)

MCP_HTTP_BEARER_TOKEN=

Set NETBOX_TOKEN_PASSTHROUGH true to make every client authenticate with its own

NetBox API token (Authorization: Bearer ); NetBox then applies that user's

permissions. NETBOX_TOKEN is ignored. Cannot be combined with MCP_HTTP_BEARER_TOKEN

NETBOX_TOKEN_PASSTHROUGH=false

🧰 Available Tools

Object types are named app.model, as NetBox itself names them (dcim.device, ipam.prefix, virtualization.virtualmachine). API paths such as dcim/devices are accepted too. With branching enabled, every tool that reads or writes objects also takes an optional branch argument.

Objects (read)
ToolDescription
netbox_list_object_typesList supported object types and their endpoints (core and discovered plugin types)
netbox_get_objectsList objects of a type with filters, fields, omit, brief, ordering, limit, offset
netbox_get_objectGet one object by ID
netbox_search_objectsFree-text search (q) across several object types at once
netbox_describe_object_typeWritable fields of a type: data type, required, choices
netbox_get_changelogsChange log entries, newest first
Specialised (read)
ToolDescription
netbox_get_statusNetBox version, plugins, workers, authenticated user and this server's modes
netbox_graphql_queryRead-only GraphQL query (mutations are rejected)
netbox_get_availableFree IPs / prefixes in a prefix or IP range, VLANs in a VLAN group, ASNs in an ASN range
netbox_trace_cableFull cable path from an interface, front/rear/console/power port or circuit termination
netbox_render_configRender a device's or VM's configuration from its config template
netbox_get_prefix_utilizationUtilization of up to 25 prefixes, computed as NetBox's UI does (child prefixes for containers, IPs and utilized ranges otherwise)
netbox_find_rack_spaceRacks in a site, location or list with room for a device of a given height (counts both faces for full-depth devices, and reservations)
netbox_list_branchesList netbox-branching branches (only with NETBOX_BRANCHING_ENABLED=true)
Write
ToolDescription
netbox_create_objectCreate one object
netbox_update_objectPartially update one object (PATCH)
netbox_bulk_create_objectsCreate up to 500 objects in one transaction
netbox_bulk_update_objectsUpdate up to 500 objects in one transaction
netbox_allocate_availableAllocate the next free IP, prefix, VLAN or ASN
netbox_connect_cableCable ports together, given by ID or by device and port name; refuses ports that are already cabled
netbox_run_scriptRun a custom script and wait for its log and output; commit defaults to false (destructiveHint)
netbox_create_branchCreate a netbox-branching branch (only with NETBOX_BRANCHING_ENABLED=true)
netbox_delete_objectDelete one object (destructiveHint)
netbox_bulk_delete_objectsDelete up to 500 objects in one transaction (destructiveHint)
Tool Tags

Every tool is tagged netbox plus a group tag, which `DI

只显示了开头部分;其余内容请在仓库中阅读

问 PopNx