检查点威胁模拟 MCP 服务器
一个模型上下文协议(MCP)服务器,提供与Check Point的威胁模拟和反病毒云服务的无缝集成. 这个服务器使AI助手能够通过一个简单,标准化的接口进行全面的恶意软件分析,文件扫描,以及威胁检测.
什么是MCP吗?
模式背景协议(MCP)服务器显示一个结构化的、机器可读的API,用于您的企业数据——为AI动力自动化、副驾驶和决策引擎所设计。 MCP通过提供清晰,上下文的安全环境片段,让你在不构建自定义的SDK或解析原始导出的情况下,查询,分析和优化复杂的系统.
为什么MCP用于威胁模拟?
现代的威胁地貌需要快速的文件分析和恶意软件检测能力. 分析可疑档案历来是一个复杂的过程,需要专门的工具和专门知识.
MCP改变这一点:以模块化,内容丰富的格式曝光了Check Point的威胁模拟和Anti-Virus服务,准备供AI系统消耗. 使大赦国际能够立即分析档案、查明威胁并提供可采取行动的安全见解.
特征
- 文件上传分析( A) - 利用检查点的云基础设施,提交威胁分析文件
- Hash 廉政保护 - 确保妥善保存文件散列,以便进行可靠的安全分析
- 多哈什支助 - 与MD5、SHA-1和SHA-256散列车兼容,以灵活识别文件
- 现状监测 - 查询分析进展,在获得结果后检索结果
- XML 详细报告 - 为恶意文件下载全面的XML报告,并提供详细分析结果
- 智能缓存 - 在上传副本之前自动检查现有分析
- 配额管理 - 监测API的使用和限制
- 只有文件路径接近 - 通过直接从磁盘读取文件来确保散列的完整性
- 合并扫描 - 以智能超时处理方式上传、等待和返回结果的单一工具
- 自动哈什计算 - 在需要AV分析时计算文件路径中缺少的 MD5 散列
实例
可疑文件分析
"这个PDF文件安全吗? 它包含什么威胁?"
+ 返回对潜在恶意软件和风险行为的详细分析.
未知的文件评估
"这可执行文件里有什么威胁? 有恶意软件吗?"
——提供跨越多台安全引擎的分类和检测细节.
批量文件验证
"证实这些下载的文件在安装前是否安全"
• 扫描多份文件并突出任何安全关切.
恶意行为识别
"这个恶意软件到底想在我的系统上做什么?"
——解释具体的恶意行为和系统影响.
威胁情报一体化
"这个文件在过去是否被认定为恶意
• 检查点的威胁情报以便进行全面评估.
安保设计决定
为什么只有文件路径?
我们优先 hash 完整性 为安全分析提供便利:
文件上传挑战 :
- Base64 编码/解码更改文件散列
- 不同散列=潜在的文件腐败/打扫
- 安全分析需要完美的散列保存
文件路径方法惠益 :
- 完美无瑕 - 从磁盘直接读取的文件保存原始散列
- 可靠的安全分析 - 没有影响分析的转换文物
- 值得信赖的结果 - 核查工作如期进行
用户工作流程 :
- 首先将文件保存到磁盘( 保留原始散列)
- 使用文件路径进行分析( 保证完整性)
- 获得可靠的安全结果
底线 : 我们选择了散列精确度而不是方便度来进行可靠的安全扫描.
配置选项
匿名使用统计: 检查点收集匿名使用统计,以帮助改进这个MCP服务器. 选择退出, 设定
TELEMETRY_DISABLED=true或用途--no-telemetry旗帜.
此服务器需要使用 Check Point 的威胁模拟云服务认证 :
API 密钥认证
- 如何获取 API 密钥 :
联系您的“ 检查点” 账户代表或支援小组, 获取威胁模拟服务的 API 密钥 .
设置以下环境变量:
API_KEY: 您的检查点威胁模拟 API 密钥
客户端配置
先决条件
下载并安装最新版本 节点.js 如果你还没有安装它.
您可以通过运行检查您的安装版本 :
node -v # Should print "v22" or higher
nvm current # Should print "v22" or higher
支持客户端
这个服务器已经与克洛德·桌面,Cursor,GitHub Copilot,和Windsurf客户端进行了测试.
预计它将与任何支持示范环境协议的MCP客户端合作.
示例
{
"mcpServers": {
"threat-emulation": {
"command": "npx",
"args": ["@chkp/threat-emulation-mcp"],
"env": {
"API_KEY": "YOUR_API_KEY"
}
}
}
}
只设定您认证方法所需的环境变量.
配置克洛德桌面应用程序
使用 Bundled MCPB(原DXT)
- 下载 MCPB 文件 : 威胁-释放.mcpb
- 打开 Claude 桌面 App 设置 → 扩展
- 拖动 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-emulation": {
"command": "npx",
"args": ["@chkp/threat-emulation-mcp"],
"env": {
// Add the configuration from the above instructions
}
}
}
}
虚拟系统
在搜索栏中输入 VSCode 设置并键入"mcp". 您应该看到编辑配置文件的选项 . 添加此配置 :
{
...
"mcp": {
"inputs": [],
"servers": {
"threat-emulation": {
"command": "npx",
"args": [
"@chkp/threat-emulation-mcp"
],
"env": {
"API_KEY": "YOUR_API_KEY"
}
}
}
},
...
}
风起浪起
在搜索栏中输入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-emulation-mcp
# or
npx @chkp/threat-emulation-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-emulation": {
"url": "http://localhost:3000/mcp"
}
}
}
发展
先决条件
- 节点.js 22+
- npm 10+ (韩语)
设置
# Install all dependencies
npm install
构建
# Build all packages
npm run build
本地运行
您可以在本地运行服务器用于开发 MCP 检查员 或任何兼容的MCP客户端.
node FULL_PATH_TO_SERVER/packages/threat-emulation/dist/index.js --api-key YOUR_API_KEY
安全通知
- 认证密钥和证书从未与模型共享. 它们仅被MCP服务器用于通过Check Point威胁模拟认证.
- 只使用您信任的客户端执行 . 恶意或不信任的客户可能会滥用你的证书或不适当地获取数据.
- 文件分析数据被曝出模型. 确保您只使用符合您的组织处理敏感数据的政策的模型和提供者.
遥测和隐私
匿名使用统计: Check Point收集匿名用法统计数据来改进这个MCP服务器. 只收集工具使用模式和匿名识别资料——没有证书、政策或敏感数据.
选择退出 : 设定 TELEMETRY_DISABLED=true 环境变量或使用 --no-telemetry 来禁用遥测收藏.