NetBox数据管理工具

MCP-NetBox是一个支持100+ NetBox资源类型的数据中心基础设施管理(DCIM)和IP地址管理(IPAM)工具,提供14种通用功能包括资源查询、创建、修改、删除、批量操作等。

  • by wonjo-linc
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 wonjo-linc/MCP-NetBox

使用说明

MCP NetBox

NetBox DCIM/IPAM的模型上下文协议(MCP)服务器。

14个通用工具支持100+NetBox资源类型。

工具列表

工具 说明
netbox_list 查询资源列表(分页,过滤)
netbox_get 查看单个资源的详细信息
netbox_create 创建资源
netbox_update 修改资源(PATCH)
netbox_delete 删除资源
netbox_search 基于文本的搜索
netbox_available_ips 查询/分配可用IP
netbox_available_prefixes 查询/分配可用子网
netbox_available_vlans 查看/分配可用VLAN
netbox_available_asns 查看/分配可用的ASN
netbox_schema 查询资源字段模式
netbox_bulk_create 批量创建
netbox_bulk_update 批量修改
netbox_bulk_delete 批量删除

部署(Dockge)

  1. 在Dockge中 mcp-netbox 创建堆栈
  2. 使用以下compose文件:
services:
  mcp-netbox:
    image: ghcr.io/wonjo-linc/mcp-netbox:latest
    container_name: mcp-netbox
    restart: unless-stopped
    ports:
      - "3101:3000"
    environment:
      - NETBOX_URL=https://netbox.example.com
      - NETBOX_API_TOKEN=your_token
      - MCP_API_KEY=your_api_key
      - OAUTH_CLIENT_ID=your_client_id
      - OAUTH_CLIENT_SECRET=your_client_secret
      - PORT=3000
  1. 在Nginx Proxy Manager中 mcp-netbox.lincsolution.net → 10.16.111.180:3101 代理设置

Claude Code集成

~/.claude.json的 mcpServers添加到:

{
  "netbox": {
    "type": "http",
    "url": "https://mcp-netbox.lincsolution.net/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_MCP_API_KEY"
    }
  }
}

Claude Web集成

设置>连接器>添加自定义连接器:

  • 服务器URL: https://mcp-netbox.lincsolution.net
  • Client ID/Client Secret:为环境变量设置的值