Nautobot Network Infrastructure

🚀 Nautobot MCP插件

此Nautobot插件將MCP（模型上下文協議）服務器與Nautobot集成，為網絡自動化和管理提供AI就緒工具和接口，助力用戶更高效地進行網絡管理與自動化操作。

🚀 快速開始

Nautobot MCP使AI助手或應用程序能夠通過標準化協議與您的網絡數據交互。該插件在Nautobot上運行一個MCP服務器，暴露可用於AI系統的工具。 更多信息可查看：MCP介紹

💻 使用示例

Librechat連接到Nautobot MCP

可參考此鏈接示例：Librechat連接示例

📦 安裝指南

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服務（生產推薦）

創建一個systemd服務文件，路徑為/etc/systemd/system/nautobot-mcp.service：

[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/

📄 待辦事項

• 添加詳細的文檔說明。
• 實現完整的API接口。
• 支持多語言功能。
• 增加錯誤處理機制。
• 優化性能表現。

整個項目仍在開發中，後續將逐步完善各項功能。