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 [Your-GitHub-Username]/checkpoint-security-mcp-servers.git
   cd checkpoint-security-mcp-servers

1. 设置虚拟环境：

   python -m venv venv
   source venv/bin/activate  # On Windows use `venv\Scripts\activate`

1. 安装依赖项：

   pip install -r requirements.txt

1. 配置检查点API访问：

- 从Check Point Management Server获取API密钥。 - 注意管理器URL（IP地址或主机名和端口。， https://192.168.1.10:443). 注： 对于在家庭实验室中使用自签名证书进行的初始测试，您可以使用 verify=False 在 httpx 调用（如示例中所示），但对于任何生产或公开环境，请确保配置了正确的证书验证。

1. 运行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

1. 连接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许可证.