安全协议集成服务

该项目旨在为Check Point安全产品构建和维护Anthropic的模型上下文协议(MCP)服务器的开源实现,通过标准化MCP实现AI代理与Check Point防火墙、终端等安全产品的无缝集成,以支持高级AI驱动的安全自动化和自主响应。

  • by ngardiner
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ngardiner/checkpoint-security-mcp-servers

使用说明

检查点安全mcp服务器

桥接人工智能和Check Point安全:Anthropic MCP服务器,为Check Point防火墙、端点等实现人工智能代理集成和自主防御。


项目目标

该项目旨在构建和维护专门为各种Check Point Software Technologies安全产品设计的Anthropic模型上下文协议(MCP)服务器的开源实现。通过标准化的MCP公开Check Point功能(如防火墙管理、端点操作、日志记录等),该项目旨在促进与AI代理的无缝集成,并释放高级AI驱动的安全自动化和自主响应的潜力。

这是一个独立的社区项目,与Check Point Software Technologies没有正式联系或认可。

什么是模型上下文协议(MCP)?

模型上下文协议(MCP)是由Anthropic开发的开放标准,为AI应用程序(如LLM和AI代理)发现外部工具和数据源并与之交互提供了一种标准化的方法。它使人工智能能够了解它可以采取什么行动(工具),可以访问什么信息(资源),以及如何在连接的系统中使用预定义的工作流(提示)。

为什么选择Check Point和MCP?

Check Point是企业环境中广泛部署的安全供应商。使AI代理能够通过MCP等标准化协议与Check Point平台进行交互,解决了复杂安全基础设施中增强自动化和自主响应的关键需求。该项目旨在弥合这一差距,并使人工智能成为以Check Point为中心的安全运营中更为集成和强大的一部分。

存储库结构

/checkpoint-security-mcp-servers
├── .gitignore
├── LICENSE
├── README.md
├── requirements.txt
└── src/
└── firewall/          # MCP server for Check Point Firewall (Management API)
├── init.py
├── server.py      # Main server entry point
└── capabilities.py  # Defines Firewall-specific Tools, Resources, Prompts
└── harmony_endpoint/  # MCP server for Check Point Harmony Endpoint
├── init.py
├── server.py
└── capabilities.py
└── common/          # Optional: for shared code (e.g., API authentication helpers)
├── init.py
└── utils.py

入门指南

要设置和运行这些MCP服务器,您需要Python 3.8+和Check Point管理服务器(用于防火墙功能)。

  1. 克隆存储库:

    git clone [https://github.com/](https://github.com/)[Your-GitHub-Username]/checkpoint-security-mcp-servers.git
    cd checkpoint-security-mcp-servers
    
  2. 设置虚拟环境:

    python -m venv venv
    source venv/bin/activate  # On Windows use `venv\Scripts\activate`
    
  3. 安装依赖项:

    pip install -r requirements.txt
    
  4. 配置检查点API访问:

    • 从Check Point Management Server获取API密钥。
    • 注意管理器URL(IP地址或主机名和端口。, https://192.168.1.10:443). 注: 对于在家庭实验室中使用自签名证书进行的初始测试,您可以使用 verify=False 在 httpx 调用(如示例中所示),但对于任何生产或公开环境,请确保配置了正确的证书验证。
  5. 运行MCP服务器(例如防火墙): 导航到存储库根目录并运行服务器脚本。

    python src/firewall/server.py
    

    服务器将启动并等待MCP客户端通过标准I/O连接。

    默认情况下,服务器使用标准I/O(stdio)为了沟通。您还可以使用指定其他传输机制 --transport 论点:

    • stdio (默认): 使用标准输入/输出。
      python src/firewall/server.py
      
    • sse (服务器发送的事件): 运行一个HTTP服务器,客户端可以连接到该服务器进行服务器发送事件。
      python src/firewall/server.py --transport sse
      
      服务器将监听 0.0.0.0:8000 使用时默认为 sse.
    • streamable-http: 运行一个HTTP服务器,客户端可以使用流式HTTP机制连接到该服务器。
      python src/firewall/server.py --transport streamable-http
      
      服务器将监听 0.0.0.0:8000 使用时默认为 streamable-http.

    使用时 sse 或 streamable-http 传输,您还可以使用可选选项指定自定义端口 --port 争论。如果未提供,则默认为 8000. 例子:

    python src/firewall/server.py --transport streamable-http --port 9999
    
  6. 连接MCP客户端:

    • 使用与MCP兼容的AI应用程序(如Anthropic的Claude Desktop,或构建/配置自己的客户端)连接到正在运行的服务器。
    • 配置客户端以识别通过标准I/O运行的本地服务器。有关如何添加本地服务器,请参阅所选MCP客户端的文档。
    • 一旦连接,人工智能应该能够发现和使用公开的工具和资源(如 checkpoint_login_test).

已实现的能力(第一阶段)

  • 防火墙MCP服务器(src/firewall/):
    • checkpoint_login_test 工具:使用API键测试与Check Point Management API的连接。(需要 manager_url 和 api_key 作为输入参数)。

待实施(未来阶段)

  • 全面实施 BlockIPTool 与API检查点管理交互。
  • 实施 FirewallLogsResource 检索日志。
  • Harmony端点MCP服务器的开发(src/harmony_endpoint/)以及它的能力。
  • 为这两个平台添加更多的工具和资源(例如,管理网络对象、策略、获取端点状态、隔离端点等)。
  • 强大的错误处理和状态管理(例如,处理登录工具建立的API会话)。
  • 改进了文档和示例。

贡献

这是一个开源项目,欢迎投稿!如果你想贡献:

  1. 分叉存储库。
  2. 为您的功能或错误修复创建一个新分支。
  3. 进行更改并确保代码通过任何测试(添加测试!)。
  4. 提交一个拉取请求,明确描述您的更改。

许可证

该项目根据 选择您的许可证,例如MIT许可证.