NetBox MCP 服务器

这是一个简单的只读 模型上下文协议 服务器，用于 NetBox。它使您能够通过支持 MCP 的 LLM 直接与 NetBox 中的数据进行交互。

工具

工具	描述
get_objects	根据类型和过滤器检索 NetBox 核心对象
get_object_by_id	通过 ID 获取有关特定 NetBox 对象的详细信息
get_changelogs	根据过滤器检索更改历史记录（审计跟踪）

注意：支持的对象类型集是显式定义的，目前仅限于核心 NetBox 对象，并且不适用于来自插件的对象类型。

用法

1. 在 NetBox 中创建一个只读 API 令牌，该令牌具有足够的权限，以便该工具可以访问您希望通过 MCP 提供的数据。

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

3. 验证服务器是否可以运行：NETBOX_URL=https://netbox.example.com/ NETBOX_TOKEN=<your-api-token> uv run server.py

4. 将 MCP 服务器配置添加到您的 LLM 客户端。 例如，在 Claude Desktop (Mac) 中：

{
  "mcpServers": {
        "netbox": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/netbox-mcp-server",
                "run",
                "server.py"
            ],
            "env": {
                "NETBOX_URL": "https://netbox.example.com/",
                "NETBOX_TOKEN": "<your-api-token>"
            }
        }
}

在 Windows 上，使用实例的完整转义路径，例如 C:\\Users\\myuser\\.local\\bin\\uv 和 C:\\Users\\myuser\\netbox-mcp-server。 有关详细的故障排除，请参阅 MCP 快速入门。

5. 在您的 LLM 客户端中使用这些工具。 例如：

> 获取 'Equinix DC14' 站点中的所有设备
...
> 告诉我有关我的 IPAM 利用率的信息
...
> 我的网络中有哪些 Cisco 设备？
...
> 谁在上周对 NYC 站点进行了更改？
...
> 显示上个月对核心路由器的所有配置更改

开发

欢迎贡献！ 请打开一个 issue 或提交一个 PR。

许可证

本项目采用 Apache 2.0 许可证。 有关详细信息，请参阅 LICENSE 文件。