PAN-OS MCP 服务器

本项目提供了一个模型控制协议 (MCP) 服务器，用于使用 XML API 与 Palo Alto Networks 防火墙进行交互。它允许您使用 Claude 或其他兼容工具，通过自然语言来管理和配置您的 PAN-OS 设备。

功能特性

• 使用 API 密钥对 PAN-OS/Panorama 设备进行身份验证
• 检索系统信息
• 执行操作命令
• 提交配置
• 执行配置操作（设置、编辑、删除、重命名等）
• 将策略从 Panorama 推送到托管设备

要求

• Python 3.13+
• Palo Alto Networks 防火墙
• 对您的 PAN-OS 设备的 API 访问权限

安装

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: 检索基本系统信息
• op_command: 使用 XML 执行操作命令
• commit_config: 提交候选配置
• commit_all_shared_policy: 将策略从 Panorama 推送到托管设备
• config_action: 使用 XPath 执行配置操作

安全注意事项

• 本项目旨在用于演示和在受控环境中使用。
• 代码中的 API 密钥应保持安全，不要提交到公共存储库。
• 对于生产用途，请确保适当的身份验证控制，并考虑添加 TLS 验证。

许可证

MIT 许可证