Netbox MCP Server

🚀 NetBox MCP サーバー

これは、NetBox 用のシンプルな読み取り専用 モデルコンテキストプロトコル サーバーです。MCP をサポートする大規模言語モデル（LLM）を通じて、NetBox データと直接やり取りすることができます。

🛠️ ツール

⚠️ 重要提示

現在サポートされているオブジェクトタイプは明確に定義され、限定的です。コア 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 サイトに変更を加えたのは誰ですか？
...
> 過去 1 か月間のコアルーターのすべての設定変更を表示する

💻 開発

貢献を歓迎します！問題を開くか、PR を提出してください。

📄 ライセンス

このプロジェクトは Apache 2.0 ライセンスの下で提供されています。