# 安装 NetBox MCP

- 类型: MCP 工具
- 说明: MCP server for NetBox DCIM/IPAM with read-only and dry-run modes
- 仓库: https://github.com/mhajder/netbox-mcp

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "NetBox MCP" MCP 服务：
执行：claude mcp add 'io-github-mhajder-netbox-mcp' -- uvx netbox-mcp
```

### Codex
```
请帮我安装 askskill 上的 "NetBox MCP" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-mhajder-netbox-mcp]
command = "uvx"
args = ["netbox-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "NetBox MCP" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-mhajder-netbox-mcp": { "command": "uvx", "args": ["netbox-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --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 --transport stdio io-github-mhajder-netbox-mcp -- uvx netbox-mcp
```
需要环境变量：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

### Codex
```bash
codex mcp add --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 io-github-mhajder-netbox-mcp -- uvx netbox-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-mhajder-netbox-mcp]
command = "uvx"
args = ["netbox-mcp"]

[mcp_servers.io-github-mhajder-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"
```
需要环境变量：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

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-mhajder-netbox-mcp": {
      "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"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-mhajder-netbox-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJuZXRib3gtbWNwIl0sImVudiI6eyJORVRCT1hfVVJMIjoiWU9VUl9WQUxVRSIsIk5FVEJPWF9UT0tFTiI6IllPVVJfVkFMVUUiLCJORVRCT1hfVkVSSUZZX1NTTCI6IllPVVJfVkFMVUUiLCJORVRCT1hfVElNRU9VVCI6IllPVVJfVkFMVUUiLCJORVRCT1hfQlJBTkNISU5HX0VOQUJMRUQiOiJZT1VSX1ZBTFVFIiwiTkVUQk9YX0JSQU5DSCI6IllPVVJfVkFMVUUiLCJORVRCT1hfUExVR0lOX0RJU0NPVkVSWSI6IllPVVJfVkFMVUUiLCJSRUFEX09OTFlfTU9ERSI6IllPVVJfVkFMVUUiLCJEUllfUlVOX01PREUiOiJZT1VSX1ZBTFVFIiwiRElTQUJMRURfVEFHUyI6IllPVVJfVkFMVUUiLCJMT0dfTEVWRUwiOiJZT1VSX1ZBTFVFIiwiUkVTUE9OU0VfTUFYX1NJWkUiOiJZT1VSX1ZBTFVFIiwiUkFURV9MSU1JVF9FTkFCTEVEIjoiWU9VUl9WQUxVRSIsIlJBVEVfTElNSVRfTUFYX1JFUVVFU1RTIjoiWU9VUl9WQUxVRSIsIlJBVEVfTElNSVRfV0lORE9XX01JTlVURVMiOiJZT1VSX1ZBTFVFIiwiVE9PTF9TRUFSQ0hfRU5BQkxFRCI6IllPVVJfVkFMVUUiLCJUT09MX1NFQVJDSF9TVFJBVEVHWSI6IllPVVJfVkFMVUUiLCJUT09MX1NFQVJDSF9NQVhfUkVTVUxUUyI6IllPVVJfVkFMVUUifX0
需要环境变量：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