Pan Os MCP

🚀 PAN-OS MCP 服務器

本項目搭建了一個 Model Control Protocol (MCP) 服務器，藉助 XML API 實現與 Palo Alto Networks 防火牆的交互。藉助該服務器，您能夠運用 Claude 或其他兼容工具，通過自然語言對 PAN-OS 設備進行管理與配置。

🚀 快速開始

本項目提供的 MCP 服務器可幫助您通過自然語言管理 PAN-OS 設備。以下是使用前的準備步驟。

✨ 主要特性

• 運用 API 密鑰身份驗證，實現與 PAN-OS/Panorama 設備的連接。
• 可獲取系統基本信息。
• 支持執行操作命令。
• 能夠提交候選配置。
• 可執行配置操作，如設置、編輯、刪除、重命名等。
• 支持從 Panorama 推送策略到管理設備。

📦 安裝指南

1. 克隆倉庫：

   git clone https://github.com/edoscars/pan-os-mcp.git
   

2. 安裝依賴項：

   pip install -r requirements.txt
   

3. 將其添加到您的 Claude Desktop 配置中（在 args 中指定正確路徑）：

   {
     "mcpServers": {
       "pan-os":{
         "command": "uv",
         "args":[
           "--directory",
           "C:\\Users\\USER\\pan-os",
           "run",
           "pan-os.py"
         ]
       }
     }
   }
   

4. 編輯 pan-os.py 文件以配置您的 PAN-OS 設備：

# -----------------------------------------------------------------------------
# Pan-OS / Panorama 配置（根據您的環境進行調整）
# -----------------------------------------------------------------------------
PA_HOST = "your-firewall-ip"
PA_API_KEY = "your-api-key"  

💻 使用示例

基礎用法

該服務器提供了多個與 PAN-OS 交互的工具，以下是部分命令的使用示例：

# 獲取基本系統信息
get_system_info()

# 使用 XML 執行操作命令
op_command()

# 提交候選配置
commit_config()

# 從 Panorama 推送策略到管理設備
commit_all_shared_policy()

# 使用 XPath 執行配置操作
config_action()

📚 詳細文檔

可用命令

• get_system_info：獲取基本系統信息。
• op_command：使用 XML 執行操作命令。
• commit_config：提交候選配置。
• commit_all_shared_policy：從 Panorama 推送策略到管理設備。
• config_action：使用 XPath 執行配置操作。

🔧 技術細節

本項目基於 Python 3.13+ 構建，通過 XML API 與 Palo Alto Networks 防火牆進行交互。它利用 API 密鑰身份驗證來確保與 PAN-OS/Panorama 設備的安全連接。在代碼實現中，通過定義不同的函數來實現各種操作，如獲取系統信息、執行操作命令、提交配置等。同時，通過編輯 pan-os.py 文件來配置 PAN-OS 設備的相關信息，如主機 IP 和 API 密鑰。

⚠️ 安全注意事項

⚠️ 重要提示

• 此項目旨在用於演示和受控環境中的使用。
• 代碼中的 API 密鑰應保持安全，不應提交到公共倉庫。
• 在生產環境中使用時，請確保適當的認證控制，並考慮添加 TLS 驗證。

📄 許可證

MIT License