netbox-mcp-server
为支持MCP的AI提供只读访问NetBox数据的工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：netbox-mcp-server。 它的用途是：为支持MCP的AI提供只读访问NetBox数据的工具。 完整的 Skill 内容见：https://321skill.com/skills/netbox-mcp-server/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我查一下数据中心里所有状态为‘活跃’的思科9300交换机，并列出它们所在的机柜和分配的IP地址。” 它会调用NetBox MCP Server的`get_objects`工具，根据你设置的过滤条件，从NetBox中获取准确的设备列表和关联信息，并以清晰的格式呈现给你。或者，当你在复盘一次网络变更时，可以
对AI说：“显示过去24小时内对‘核心路由器’设备类型所做的所有变更记录。” AI会使用`get_changelogs`工具，为你提供详细的审计追踪信息。
介绍
NetBox MCP Server 是一个基于模型上下文协议（MCP）的工具，它解决了AI助手无法直接查询和利用NetBox（一款流行的网络基础设施资源管理平台）中丰富数据的问题。通过这个服务器，AI可以安全地读取NetBox中的核心对象、变更记录等信息，将静态的网络资产数据转化为动态的、可对话的知识。
使用前，你需要在NetBox中创建一个只读API令牌，并配置好环境变量。安装依赖后，可以通过命令行启动服务器，并将其添加到支持MCP的AI客户端（如Claude Desktop/Code）中。配置支持Stdio和HTTP两种传输方式，方便在不同场景下集成。
这个工具非常适合依赖NetBox数据进行网络规划、故障排查、变更审计的运维工程师、网络工程师以及智能体开发者。它能让AI在回答关于网络拓扑、IP地址分配、设备型号等问题时，直接引用NetBox中的权威数据，提升回答的准确性和实用性。
需要注意的是，这是一个只读服务器，默认无法修改NetBox数据，确保了安全性。v1.0.0版本有破坏性变更，升级时需仔细阅读变更日志并调整配置。对于需要写入操作或更复杂查询（如GraphQL）的场景，建议考虑分叉项目进行二次开发。
核心特点
这是专为NetBox设计的官方MCP服务器，提供开箱即用的只读数据访问，并支持自动发现NetBox插件中的对象类型，无需手动配置模型。其设计哲学是简单、安全、易于分叉，将复杂功能排除在核心范围之外，鼓励用户根据自身需求进行定制。
注意事项
该Skill仅提供只读访问，不支持通过AI对NetBox数据进行任何修改、创建或删除操作。
常见问题
如何将NetBox MCP Server添加到Claude Desktop？
需要编辑Claude Desktop的配置文件，添加使用Stdio或HTTP传输方式的服务器配置，并设置正确的NETBOX_URL和NETBOX_TOKEN环境变量。
这个服务器支持查询NetBox插件的数据吗？
支持，服务器可以自动发现并支持NetBox插件中的对象类型进行查询。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/netbox-mcp-server/raw/index.md 读取 netbox-mcp-server 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/netbox-mcp-server/raw/index.md（查看排版版本）