@chkp/threat-prevention-mcp

中文文档
1.6.3发布于 2026/11/08MITTypeScriptES Module构建来源已验证近 30 天下载 2146

用于检查点产品的威胁预防MCP服务器

中文使用文档
文档目录36 节
  1. 什么是MCP吗?
  2. 为什么是保安局?
  3. 特征
  4. 管理 API 版本
  5. 演示
  6. 实例
  7. 威胁保护分析
  8. CVE 脆弱性评估
  9. IPS 健康监测
  10. 威胁情报审查
  11. 例外分析和安全漏洞
  12. 网关安全态势评估
  13. 最佳化
  14. 配置选项
  15. 1. 智能一云(API键)
  16. 2. Prem 管理(API 键或用户名/密码)
  17. 客户端配置
  18. 先决条件
  19. 支持客户端
  20. 智能一号云示例
  21. 在线管理示例
  22. 多域服务器( MDS)
  23. 配置克洛德桌面应用程序
  24. 虚拟系统
  25. 风起浪起
  26. 光标
  27. HTTP 运输
  28. 以 HTTP 模式启动服务器
  29. 连接 MCP 客户端
  30. 发展
  31. 先决条件
  32. 设置
  33. 构建
  34. 本地运行
  35. 安全通知
  36. 遥测和隐私

检查点威胁预防

什么是MCP吗?

模式背景协议(MCP)服务器显示一个结构化的、机器可读的API,用于您的企业数据——为AI动力自动化、副驾驶和决策引擎所设计。 MCP通过提供清晰,上下文的安全环境片段,让你在不构建自定义的SDK或解析原始导出的情况下,查询,分析和优化复杂的系统.

为什么是保安局?

安全政策往往跨越数百个规则和数千个不同执行点的目标。 了解、审计或优化这些环境是缓慢的,容易出错. MCP改变了这一点:以模块化,内容丰富的格式曝光安全管理数据,可以随时为AI系统所消耗. 使人工智能能够准确使用你的数据. 问现实世界的问题,立即得到结构化、可操作的答案.

特征

  • 威胁保护管理:查询和分析威胁保护、概况和指标
  • IPS(入侵预防系统)监测: 检查 IPS 状态、 更新时间表和保护属性
  • IOC 种子管理: 查看和分析威胁情报信息和妥协指标

管理 API 版本

此服务器支持 管理 API v2.1 (R82.10+). 它一般与更早的版本相容;一些参数可能无法从更老的管理服务器上获取.

演示

Watch the demo

实例

威胁保护分析

"给我看所有高强度威胁保护 目前在我网络上活跃"
• 分析保护威胁的配置,并提供详细的安保信息.

CVE 脆弱性评估

"检查CVE-2024-1234 是否保护在我的所有网关"
· 在整个网关政策和威胁概况中进行全面的CVE保护分析.

IPS 健康监测

"目前IPS状态如何,上次签名更新是什么时候安排的"
提供实时IPS刀片状态、更新时间表和保护数据库信息.

威胁情报审查

"列出所有活跃的IOC输入和显示赎金威胁的指标"
· 显示威胁情报资料、妥协指标及其运作状况.

例外分析和安全漏洞

"显示所有威胁规则例外 并找出潜在的绕行弱点"
• 审查例外群体和规则,以突出威胁可能逃避保护的领域.

网关安全态势评估

哪些网关可以预防威胁? 哪些保护是活跃的
• 全面了解防止威胁的网关配置和政策任务.

最佳化

"分析我的预防威胁规则 并提出改进建议 以更好地覆盖"
• 审查威胁层、规则和概况,以建议加强安全.


配置选项

匿名使用统计: 检查点收集匿名使用统计,以帮助改进这个MCP服务器. 选择退出, 设定 TELEMETRY_DISABLED=true 或用途 --no-telemetry 旗帜.

此服务器支持两个主要认证模式:

1. 智能一云(API键)

授权使用 API 键检查点 Smart-1 Cloud .

  • 如何生成 API 密钥 :
    在你的智能一号云仪表板,去 设置 → API & SmartConsole 生成 API 密钥.
    复制密钥和服务器登录 URL(不包括 /login 后缀)为您的客户端设置.
    alt text

设置以下环境变量:

  • API_KEY: 您的 Smart-1 Cloud API 键
  • S1C_URL: 您的智能一云租户"Web- API" URL

2. Prem 管理(API 键或用户名/密码)

  • 配置您的管理服务器以允许 API 访问 :
    要使用此服务器, 您必须首先启用 API 访问 .
    执行官方指示 通过API管理安全。 。 。 .

  • 认证到安全管理服务器 使用 API 键或用户名/密码:

    • 遵照官方指示: 行政主管账户(R81+点)
    • 在创建管理员时,为API访问和管理操作分配适当的权限.
    • 可以使用API密钥(为自动化推荐)或用户名/密码证书进行认证.

设置以下环境变量:

  • MANAGEMENT_HOST: 您管理服务器的 IP 地址或主机名
  • PORT: (可选) 管理服务器端口(默认: 443)
  • API_KEY: 您的管理 API 密钥( 如果使用 API 密钥认证)
  • USERNAME: 认证的用户名( 如果使用用户名/ 密码名认证)
  • PASSWORD: 认证密码( 如果使用用户名/ 密码认证)

客户端配置

先决条件

下载并安装最新版本 节点.js 如果你还没有安装它.
您可以通过运行检查您的安装版本 :

node -v      # Should print "v20" or higher
nvm current  # Should print "v20" or higher

支持客户端

这个服务器已经与克洛德·桌面,Cursor,GitHub Copilot,和Windsurf客户端进行了测试.
预计它将与任何支持示范环境协议的MCP客户端合作.

说明: 由于管理API调用的性质以及服务器工具的种类,使用此服务器可能需要向模型提供者付费订阅以支持令牌限制和上下文窗口大小.
对于更小的模型,可以通过限制客户端中启用工具的数量来减少符号使用.

智能一号云示例

{
  "mcpServers": {
    "threat-prevention": {
      "command": "npx",
      "args": ["@chkp/threat-prevention-mcp"],
      "env": {
        "API_KEY": "YOUR_API_KEY",
        "S1C_URL": "YOUR_S1C_URL" // e.g., https://xxxxxxxx.maas.checkpoint.com/yyyyyyy/web_api
      }
    }
  }
}

在线管理示例

{
  "mcpServers": {
    "threat-prevention": {
      "command": "npx",
      "args": ["@chkp/threat-prevention-mcp"],
      "env": {
        "MANAGEMENT_HOST": "YOUR_MANAGEMENT_IP_OR_HOST_NAME",
        "MANAGEMENT_PORT": "443", // optional, default is 443
        "API_KEY": "YOUR_API_KEY", // or use USERNAME and PASSWORD
        "USERNAME": "YOUR_USERNAME", // optional
        "PASSWORD": "YOUR_PASSWORD"  // optional
      }
    }
  }
}

只设定您认证方法所需的环境变量.

多域服务器( MDS)

在多域服务器上,服务器登录到系统域,您每个请求选择一个域,例如"显示域欧洲的主机".

如果您的证书没有系统域访问权限, 设置 MANAGEMENT_DOMAIN (或通过) --management-domain)到它们可以访问的域,用逗号分隔. 服务器登录到第一个域, 当请求命名为无域时使用. 这样的证书无法列出系统的域名,所以列表是助手如何知道它能提供哪些其他域名;您的任何域名在命名时都可以访问.

"env": {
  "MANAGEMENT_HOST": "YOUR_MDS_IP_OR_HOST_NAME",
  "MANAGEMENT_DOMAIN": "DOMAIN_1,DOMAIN_2", // only when you have no System Domain access
  "API_KEY": "YOUR_API_KEY"
}

配置克洛德桌面应用程序

使用 Bundled MCPB(原DXT)

  1. 下载 MCPB 文件 : 威胁预防工作
  2. 打开 Claude 桌面 App 设置 → 扩展
  3. 拖动 MCPB 文件并按指令配置 .

或者手动配置

对于macOS:

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Open the config file in TextEdit
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

对于 Windows :

code %APPDATA%\Claude\claude_desktop_config.json

添加服务器配置 :

{
  "mcpServers": {
    "threat-prevention": {
      "command": "npx",
      "args": ["@chkp/threat-prevention-mcp"],
      "env": {
        // Add the configuration from the above instructions
      }
    }
  }
}

虚拟系统

在搜索栏中输入 VSCode 设置并键入"mcp". 您应该看到编辑配置文件的选项 . 添加此配置 :

{
  ...
  "mcp": {
    "inputs": [],
    "servers": {
      "threat-prevention": {
        "command": "npx",
        "args": [
          "@chkp/threat-prevention-mcp"
        ],
        "env": {
          "MANAGEMENT_HOST": "YOUR_MANAGEMENT_IP_OR_HOST_NAME",
          "MANAGEMENT_PORT": "443",  // optional, default is 443
          "API_KEY": "YOUR_API_KEY", // or use USERNAME and PASSWORD
          "USERNAME": "YOUR_USERNAME", // optional
          "PASSWORD": "YOUR_PASSWORD" // optional
        }
      }
    }
  },
  ...
}

风起浪起

在搜索栏中输入Windsurf设置并输入"mcp". 您应该看到编辑配置文件的选项 . 添加配置为 Claude 桌面 App .

光标

在左菜单中输入光标设置并点击"MCP服务器". 您应该看到添加一个新的 MCP 服务器的选项 . 添加配置为 Claude 桌面 App .


HTTP 运输

默认情况下,此服务器使用 静态 transport,是克洛德桌面和Cursor等MCP客户端的标准模式. 对主机或多用户部署 HTTP 运输 (MCP可流式HTTP)也可用.

继续前的安全通知 : HTTP服务器没有内置认证,也没有TLS. 任何能够到达端口的客户端都可以建立会话,并使用清晰文本的证书旅行. 只使用HTTP运输在认证的倒置代理(nginx, Caddy, a 云负载平衡器)后终止TLS并强制认证. 如果您正在运行与您的 MCP 客户端相同的机器上的服务器, 请使用默认的 stdio 传输 —— 它没有这些关切 .

以 HTTP 模式启动服务器

MCP_TRANSPORT_TYPE=http MCP_TRANSPORT_PORT=3000 npx @chkp/threat-prevention-mcp
# or
npx @chkp/threat-prevention-mcp --transport http --transport-port 3000

服务器曝光:

  • POST/GET/DELETE /mcp - MCP协议终点
  • GET /health — 服务器状态( 活动会话数, 版本)

连接 MCP 客户端

对准您的 MCP 客户端 http://<host>:3000/mcp。克劳德桌面示例claude_desktop_config.json:

{
  "mcpServers": {
    "threat-prevention": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

发展

先决条件

  • 节点.js 20+
  • npm 10+ (韩语)

设置

# Install all dependencies
npm install

构建

# Build all packages
npm run build

本地运行

您可以在本地运行服务器用于开发 MCP 检查员 或任何兼容的MCP客户端.

node FULL_PATH_TO_SERVER/packages/threat-prevention/dist/index.js --s1c-url|--management-host --api-key|--username|--password

安全通知

  1. 认证密钥和证书从未与模型共享. 它们只被 MCP 服务器用来认证您的 Check Point 管理系统 .
  2. 只使用您信任的客户端执行 . 恶意或不信任的客户可能会滥用你的证书或不适当地获取数据.
  3. 管理数据被曝出该模型. 确保您只使用符合您的组织处理敏感数据和PII的政策的模型和提供者.

遥测和隐私

匿名使用统计: Check Point收集匿名用法统计数据来改进这个MCP服务器. 只收集工具使用模式和匿名识别资料——没有证书、政策或敏感数据.

选择退出 : 设定 TELEMETRY_DISABLED=true 环境变量或使用 --no-telemetry 来禁用遥测收藏.

版本与发布记录

@chkp/threat-prevention-mcp 共发布 30 个版本,首次发布于 2025/07/01;过去 12 个月发布了 16 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.6.3latest2026/11/081 天前
1.6.22026/11/028 天前
1.5.112026/10/2515 天前
1.5.102026/10/051 个月前
1.5.82026/08/202 个月前
1.5.72026/07/133 个月前

关于 @chkp/threat-prevention-mcp 的常见问题

@chkp/threat-prevention-mcp 是什么?

用于检查点产品的威胁预防MCP服务器

如何安装 @chkp/threat-prevention-mcp?

在项目目录运行 npm install @chkp/threat-prevention-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 threat-prevention-mcp,可以用 npx threat-prevention-mcp 直接运行。

@chkp/threat-prevention-mcp 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@chkp/threat-prevention-mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@chkp/threat-prevention-mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@chkp/threat-prevention-mcp 可以商用吗?

@chkp/threat-prevention-mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@chkp/threat-prevention-mcp 的下载量有多少?

根据 npm 官方下载统计,@chkp/threat-prevention-mcp 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,146 次,日均约 72 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@chkp/threat-prevention-mcp 还在维护吗?

最新版本 1.6.3 发布于 2026/11/08(1 天前);至今共发布 30 个版本,其中过去 12 个月发布了 16 个;首次发布于 2025/07/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。