netboxlabs/netbox-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

254 stars 111 forks 품질 85 트렌드 39Apache-2.0

Repository Install

netboxlabs/netbox-mcp-server는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

netboxlabs/netbox-mcp-server는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

** ⚠️ v1.0.0의 주요 변경사항**: 프로젝트 구조가 변경되었습니다. v0.1.0에서 업그레이드할 경우, 설정을 업데이트하세요:

uv run server.py를 [[T1]로 변경하세요.

Claude 데스크탑/코드 설정을 server.py 대신 netbox-mcp-server로 업데이트하세요.

Docker 사용자: 업데이트된 CMD로 이미지를 재구축하기

자세한 내용은 CHANGELOG.md 참조

이것은 NetBox용 간단한 읽기 전용 모델 컨텍스트 프로토콜 서버입니다. MCP를 지원하는 LLM을 통해 NetBox 내 데이터와 직접 상호작용할 수 있게 해줍니다.

서버는 의도적으로 단순합니다: 시작하기 쉽고, 오용 가능성이 낮으며(기본적으로 읽기 전용, 플러그인 서피 없음), 포크 및 적응이 용이합니다. Apache 2.0 하의 포크는 프로젝트 범위를 넘어서는 기능이 필요한 사용자에게 일류 경로입니다.

커뮤니티

채팅, 사용 사례, 일반 MCP 토론을 위해 netdev.chat의 NetBox 커뮤니티에 참여하세요. #ai 채널은 MCP 통합, 질문, 사용 사례 공유를 위한 적절한 공간입니다. 이 서버에 특화된 버그와 기능 아이디어는 이슈에 포함됩니다.

도구

도구	설명
get_objects	타입과 필터를 기반으로 NetBox 핵심 객체를 검색합니다

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

NetBox MCP Server

⚠️ Breaking Change in v1.0.0: The project structure has changed. If upgrading from v0.1.0, update your configuration:

Change uv run server.py to uv run netbox-mcp-server

Update Claude Desktop/Code configs to use netbox-mcp-server instead of server.py

Docker users: rebuild images with updated CMD

See CHANGELOG.md for full details

This is a simple read-only Model Context Protocol server for NetBox. It enables you to interact with your data in NetBox directly via LLMs that support MCP.

The server is intentionally simple: easy to get started with, hard to misuse (read-only by default, no plugin surface), and easy to fork and adapt. Forking under Apache 2.0 is a first-class path for users who need capabilities beyond the project’s scope.

Community

For chat, use cases, and general MCP discussion, join the NetBox community at netdev.chat. The #ai channel is the right home for MCP integrations, questions, and sharing use cases. Bugs and feature ideas specific to this server go in issues.

Tools

Tool	Description
get_objects	Retrieves NetBox core objects based on their type and filters
get_object_by_id	Gets detailed information about a specific NetBox object by its ID
get_changelogs	Retrieves change history records (audit trail) based on filters

Note: Core NetBox object types are always available. Plugin object types can be auto-discovered. See Plugin Object Type Discovery. Advanced features (GraphQL, dynamic model discovery, etc.) are deliberately out of scope. See CONTRIBUTING.md for the full scope statement and rationale.

Usage

Create a read-only API token in NetBox with sufficient permissions for the tool to access the data you want to make available via MCP.

Install dependencies:

# Using UV (recommended)
uv sync

# Or using pip
pip install -e .

Verify the server can run: NETBOX_URL=https://netbox.example.com/ NETBOX_TOKEN= uv run netbox-mcp-server
Add the MCP server to your LLM client. See below for some examples with Claude.

Claude Code

Stdio Transport (Default)

Add the server using the claude mcp add command:

claude mcp add --transport stdio netbox \
  --env NETBOX_URL=https://netbox.example.com/ \
  --env NETBOX_TOKEN= \
  -- uv --directory /path/to/netbox-mcp-server run netbox-mcp-server

Important notes:

Replace /path/to/netbox-mcp-server with the absolute path to your local clone
The -- separator distinguishes Claude Code flags from the server command
Use --scope project to share the configuration via .mcp.json in version control

GitHub에서 전체 README 보기

설치

docker run --rm \

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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