NetBox MCP Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

NetBox MCP Server 是一个用于与 NetBox 数据进行交互的只读服务器，通过 MCP 协议支持 LLM 直接访问和查询数据。

核心功能

• get_objects: 根据类型和过滤器检索 NetBox 核心对象。
• get_object_by_id: 通过 ID 获取特定 NetBox 对象的详细信息。
• get_changelogs: 根据过滤器检索变更历史记录（审计跟踪）。

适用场景

• 通过 LLM 查询 NetBox 中的设备、IPAM 利用率等信息。
• 跟踪特定站点或设备的变更历史。
• 获取网络设备的详细信息和配置变更。

工具列表

• get_objects: 检索 NetBox 核心对象。
• get_object_by_id: 获取特定对象的详细信息。
• get_changelogs: 检索变更历史记录。

常见问题解答

• 目前仅支持 NetBox 核心对象，不支持插件中的对象类型。
• 需要创建具有足够权限的只读 API 令牌。

使用教程

使用依赖

1. 安装依赖：uv add -r requirements.txt

安装教程

1. 创建 NetBox 的只读 API 令牌。
2. 运行服务器：NETBOX_URL=https://netbox.example.com/ NETBOX_TOKEN=<your-api-token> uv run server.py
3. 在 LLM 客户端中添加 MCP 服务器配置。

调试方式

• 确保环境变量 NETBOX_URL 和 NETBOX_TOKEN 正确设置。
• 参考 MCP quickstart 进行详细故障排除。