netboxlabs/netbox-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

252 stars 109 forks 品質 85 トレンド 39Apache-2.0

Repository Install

netboxlabs/netbox-mcp-serverは、https://github.com/netboxlabs/netbox-mcp-server.からインポートされたMCPサーバー候補です。

概要

netboxlabs/netbox-mcp-serverは、https://github.com/netboxlabs/netbox-mcp-server.からインポートされたMCPサーバー候補です。

概要（AI 翻訳）

** ⚠️ v1.0.0の重大な変更:プロジェクト構造が変更されました。 v0.1.0からのアップグレードの場合は、設定を更新してください:

uv run server.pyをuv run netbox-mcp-serverに変更する]

Claude Desktop/Codeの設定を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>"
            }
        }
    }
}