Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
作者提供的说明(英文原文)
MCP server for NetBox DCIM/IPAM with read-only and dry-run modes
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
选择你使用的 AI 应用,然后复制设置。
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标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。
你需要
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
打开 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/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"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
粘贴到项目中的 .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_VERIFY_SSL envNETBOX_TIMEOUT envNETBOX_BRANCHING_ENABLED envNETBOX_BRANCH envNETBOX_PLUGIN_DISCOVERY envREAD_ONLY_MODE envDRY_RUN_MODE envDISABLED_TAGS envLOG_LEVEL envRESPONSE_MAX_SIZE envRATE_LIMIT_ENABLED envRATE_LIMIT_MAX_REQUESTS envRATE_LIMIT_WINDOW_MINUTES envTOOL_SEARCH_ENABLED envTOOL_SEARCH_STRATEGY envTOOL_SEARCH_MAX_RESULTS env这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日
注册名称已通过 GitHub 账户 mhajder 验证,该账户拥有此仓库
我们还没有从 GitHub 读取这个仓库
我们还没有从 GitHub 读取这个仓库
它在你的电脑上运行,没有互联网端点
在你的电脑上运行,改用本地设置
它在你的电脑上运行;我们只能读取互联网端点的工具列表
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 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
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Windows computer use in the background: desktop apps driven without your mouse or keyboard.
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
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).
fields, omit and brief - the tools steer the model to use themcommit is set)Bearer nbt_...) and legacy v1 (Token ...) API tokensnetbox_dns.zone)__in, multi-hop lookups)omit, v2 tokens, /api/authentication-check/) are used when the server detects themThe easiest way to get started is to install from PyPI:
# Using UV (recommended)
uvx netbox-mcp
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
git clone https://github.com/mhajder/netbox-mcp.git
cd netbox-mcp
# Using UV (recommended)
uv sync
pip install -e .
cp .env.example .env
# Using UV (recommended)
uv run netbox-mcp
netbox-mcp
A Docker image is available on GitHub Packages for easy deployment.
docker pull ghcr.io/mhajder/netbox-mcp:latest
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
uv run pytest
uv run pytest --cov=src/
uv run ruff check . uv run ruff format .
uv run ty check .
uv run prek install
# NetBox MCP Server Environment Configuration
NETBOX_URL=https://netbox.example.com
NETBOX_TOKEN=nbt_your-key.your-token
NETBOX_VERIFY_SSL=true
NETBOX_TIMEOUT=30
NETBOX_BRANCHING_ENABLED=false
NETBOX_BRANCH=
NETBOX_PLUGIN_DISCOVERY=false
READ_ONLY_MODE=false
DRY_RUN_MODE=false
DISABLED_TAGS=
LOG_LEVEL=INFO
RESPONSE_MAX_SIZE=
RATE_LIMIT_ENABLED=false RATE_LIMIT_MAX_REQUESTS=60 RATE_LIMIT_WINDOW_MINUTES=1
TOOL_SEARCH_ENABLED=false
TOOL_SEARCH_STRATEGY=bm25
TOOL_SEARCH_MAX_RESULTS=5
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.
| Tool | Description |
|---|---|
netbox_list_object_types | List supported object types and their endpoints (core and discovered plugin types) |
netbox_get_objects | List objects of a type with filters, fields, omit, brief, ordering, limit, offset |
netbox_get_object | Get one object by ID |
netbox_search_objects | Free-text search (q) across several object types at once |
netbox_describe_object_type | Writable fields of a type: data type, required, choices |
netbox_get_changelogs | Change log entries, newest first |
| Tool | Description |
|---|---|
netbox_get_status | NetBox version, plugins, workers, authenticated user and this server's modes |
netbox_graphql_query | Read-only GraphQL query (mutations are rejected) |
netbox_get_available | Free IPs / prefixes in a prefix or IP range, VLANs in a VLAN group, ASNs in an ASN range |
netbox_trace_cable | Full cable path from an interface, front/rear/console/power port or circuit termination |
netbox_render_config | Render a device's or VM's configuration from its config template |
netbox_get_prefix_utilization | Utilization of up to 25 prefixes, computed as NetBox's UI does (child prefixes for containers, IPs and utilized ranges otherwise) |
netbox_find_rack_space | Racks 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_branches | List netbox-branching branches (only with NETBOX_BRANCHING_ENABLED=true) |
| Tool | Description |
|---|---|
netbox_create_object | Create one object |
netbox_update_object | Partially update one object (PATCH) |
netbox_bulk_create_objects | Create up to 500 objects in one transaction |
netbox_bulk_update_objects | Update up to 500 objects in one transaction |
netbox_allocate_available | Allocate the next free IP, prefix, VLAN or ASN |
netbox_connect_cable | Cable ports together, given by ID or by device and port name; refuses ports that are already cabled |
netbox_run_script | Run a custom script and wait for its log and output; commit defaults to false (destructiveHint) |
netbox_create_branch | Create a netbox-branching branch (only with NETBOX_BRANCHING_ENABLED=true) |
netbox_delete_object | Delete one object (destructiveHint) |
netbox_bulk_delete_objects | Delete up to 500 objects in one transaction (destructiveHint) |
Every tool is tagged netbox plus a group tag, which `DI
只显示了开头部分;其余内容请在仓库中阅读