Nautobot Network Infrastructure

🚀 Nautobot MCPプラグイン

このNautobotプラグインは、MCP（モデルコンテキストプロトコル）サーバーをNautobotと統合し、ネットワーク自動化と管理のためのAI対応ツールとインターフェースを提供します。

🚀 クイックスタート

Nautobot MCPは、AIアシスタントまたはアプリケーションが標準化されたプロトコルを介してネットワークデータと対話できるようにします。このプラグインはNautobot上でMCPサーバーを実行し、AIシステムで使用できるツールを公開します。

https://modelcontextprotocol.io/introduction

💻 使用例

基本的な使用法

LibrechatをNautobot MCPに接続する

https://github.com/user-attachments/assets/283d68c2-d35f-4506-b909-45c1850e7281

📦 インストール

1. パッケージのインストール

pip install nautobot-mcp

2. Nautobot設定のINSTALLED_APPSに追加

# あなたのnautobot_config.py内
PLUGINS = [
    "nautobot_mcp",
    # その他のプラグイン...
]

3. 設定

Nautobotの設定システムを通じて設定を行います。

# あなたのnautobot_config.py内
PLUGINS_CONFIG = {
    "nautobot_mcp": {
        "MCP_PORT": 8005,  # MCPサーバーのポート
        "MCP_HOST": "0.0.0.0",  # デフォルトは0.0.0.0
        "MCP_CUSTOM_TOOLS_DIR": "/path/to/your/custom/tools",  # カスタムツールのディレクトリ
        "MCP_LOAD_CORE_TOOLS": False,  # 組み込みツールを読み込む
    },
}

4. nautobotのアップグレード後のコマンドを実行

nautobot-server post_upgrade

🔧 技術詳細

カスタムツール

MCP_CUSTOM_TOOLS_DIRで指定されたディレクトリ内にPython関数を定義することで、独自のカスタムツールを作成できます。

カスタムツールの例

# /path/to/your/custom/tools/my_tools.py内
def some_tool(param1: str, param2: str) -> dict:
    """Some tool description"""
    # あなたの実装コード
    return {"result": f"Tool result for {param1} and {param2}"}

MCPサーバーは、指定されたディレクトリ内のすべての関数ツールを自動的に検出して登録します。

デプロイオプション

方法1：手動起動

MCPサーバーを手動で起動できます。

nautobot-server start_mcp_server

方法2：Systemdサービス（本番環境での推奨）

/etc/systemd/system/nautobot-mcp.serviceにsystemdサービスファイルを作成します。

[Unit]
Description=Nautobot MCP Server
After=network-online.target
Wants=network-online.target

[Service]
User=nautobot
Group=nautobot
WorkingDirectory=/opt/nautobot
ExecStart=/opt/nautobot/venv/bin/nautobot-server start_mcp_server
Restart=on-failure
RestartSec=30
PrivateTmp=true

[Install]
WantedBy=multi-user.target

次に、サービスを有効にして起動します。

sudo systemctl daemon-reload
sudo systemctl enable --now nautobot-mcp.service

利用可能なツールの確認

NautobotのWebインターフェースですべての登録されたツールを確認できます。

https://あなたのドメイン/nautobot/

未完成事項（TODO）

• 詳細なドキュメントを追加する。
• 完全なAPIインターフェースを実装する。
• 多言語機能をサポートする。
• エラー処理メカニズムを追加する。
• パフォーマンスを最適化する。

このプロジェクトはまだ開発中であり、今後徐々に機能が充実していきます。