关于 checkmarx
Checkmarx 提供 MCP 服务,将 AI 编码助手连接到 Checkmarx One,以执行安全扫描、查看发现、管理项目并应用 AI 生成的修复。仓库还包含面向不同客户端的 Developer Assist 插件,可在文件写入磁盘前扫描内容。
主要功能
- 01扫描项目并查看安全发现
- 02应用 AI 生成的修复
- 03管理 Checkmarx One 项目
- 04扫描并拦截可扫描文件写入
- 05支持多种编码客户端插件
适用场景
- 01通过支持 MCP 的助手扫描代码
- 02在代码生成期间检查漏洞
- 03在易受攻击的文件修改写入前拦截
MCP 相关
托管的 MCP 服务向 MCP 客户端提供 Checkmarx One 扫描、发现查看、项目管理和修复工具。Developer Assist 插件也会启动同一服务以应用修复。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://{cxone_base_url}/api/security-mcp/mcp/{tenant_id}claude mcp add --transport http com-checkmarx-checkmarx https://{cxone_base_url}/api/security-mcp/mcp/{tenant_id}{"mcpServers":{"com-checkmarx-checkmarx":{"type":"http","url":"https://{cxone_base_url}/api/security-mcp/mcp/{tenant_id}"}}}在 Cursor 中打开{"servers":{"com-checkmarx-checkmarx":{"type":"http","url":"https://{cxone_base_url}/api/security-mcp/mcp/{tenant_id}"}}}在 VS Code 中打开{"mcpServers":{"com-checkmarx-checkmarx":{"type":"http","url":"https://{cxone_base_url}/api/security-mcp/mcp/{tenant_id}"}}}{"mcpServers":{"com-checkmarx-checkmarx":{"serverUrl":"https://{cxone_base_url}/api/security-mcp/mcp/{tenant_id}"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Checkmarx Agentic AI
专为 AI 编码 Agent 打造的 Checkmarx 应用安全。
概述
AI 编码助手可以快速生成代码,但这些代码也可能带有与手写代码相同的安全风险。此代码库将 Checkmarx One(Checkmarx 的应用安全平台)接入这些助手,以便在生成代码时扫描漏洞,而不是等到事后再扫描。
此代码库提供了 两 种互补方式,可将 Checkmarx One 集成到 AI 辅助工作流中。可以一起使用,也可以单独使用——它们分别解决问题的不同部分。
- Checkmarx Security MCP — 一个托管的 MCP 服务,任何支持 MCP 的助手都可以调用它来按需扫描、检查发现项并应用 AI 修复。
- Developer Assist 插件 — 故障关闭式门禁,在可扫描文件写入落盘之前进行扫描,适用于 Claude Code、Cursor、GitHub Copilot CLI、Codex CLI 和 Gemini CLI。
| 组成部分 | 功能 | 适用场景 |
|---|---|---|
| Checkmarx Security MCP | 助手可以调用的工具——扫描项目、检查发现项、应用 AI 修复 | 你希望在任何 MCP 客户端中按需扫描并使用修复工作流 |
| Developer Assist 插件 | 故障关闭式门禁——在可扫描文件写入落盘之前进行扫描 | 你希望检查自动执行且不可跳过 |
这些插件通过 Checkmarx One CLI(ast-cli)(cx)完成安装、身份验证和原生钩子扫描,并启动同一个 MCP 服务以进行修复。
Checkmarx Security MCP
一个托管的 MCP 服务,可将任何支持 MCP 的 AI 客户端——Claude、Cursor、Copilot、Windsurf、Kiro——连接到 Checkmarx One。它提供扫描、发现项、项目管理和 AI 生成的修复等工具,供助手在对话中调用。
配置一次即可(参见 examples/ 中各客户端的配置),然后提出请求。
详情 → README-MCP.md
Cursor:仅安装 MCP
plugins/cx-cursor-plugin 是一个轻量级 Cursor 市场插件,仅注册 Checkmarx MCP 服务——没有钩子链、没有文件写入门禁,只有 MCP 工具。如果你希望在 Cursor 中使用 Checkmarx MCP 工具,但不采用 Developer Assist 门禁,请使用此插件。
详情 → plugins/cx-cursor-plugin/README.md
开发者辅助插件
每个插件都为其客户端提供相同的默认拒绝安全防护,并以原生钩子的形式接入。在 Agent 写入或编辑可扫描文件之前,Checkmarx cx CLI 会扫描拟议内容——发现真实漏洞时会阻止操作,而不是默许通过;如果无法信任扫描器能正常运行,也会阻止操作。Shell 命令不受此防护限制。可通过捆绑的 Checkmarx MCP 服务修复发现的问题。各客户端的市场安装和 cx 引导式设置遵循相同模式;区别仅在于客户端集成方式。
| 插件 | 客户端 | 详情 |
|---|---|---|
cx-devassist | Claude Code | plugins/cx-devassist/README.md |
cursor-devassist | Cursor | plugins/cursor-devassist/README.md |
copilot-devassist | GitHub Copilot CLI | plugins/copilot-devassist/README.md |
codex-devassist | Codex CLI | plugins/codex-devassist/README.md |
| 根扩展 | Gemini CLI | docs/gemini-cli-devassist.md |
Checkmarx One CLI
这些插件会安装并驱动来自 Checkmarx/ast-cli 的 Checkmarx One CLI(cx)。该 CLI 封装了 Checkmarx One API,用于扫描、身份验证以及原生 Agent 钩子扫描器(ASCA、KICS、SCA)。
发行版和平台下载:ast-cli releases。
文档
- README-MCP.md — MCP 服务概览、身份验证和客户端配置
- docs/usage.md — MCP 工具目录和工作流示例
- docs/authentication.md — API 密钥和 OAuth2 设置
- docs/troubleshooting.md — 连接、身份验证和扫描问题
- docs/gemini-cli-devassist.md — Gemini CLI 扩展安装、钩子和技能
- CONTRIBUTING.md — 如何参与贡献
参与贡献
我们欢迎反馈和贡献。开始之前,请参阅:
- Checkmarx 贡献指南
- 行为准则
- SECURITY.md — 报告漏洞
许可证
本项目根据 Apache 2.0 许可证发布。该许可证适用于此代码库中的所有内容,包括 MCP 服务和所有插件。
反馈
我们非常期待您的反馈!如果您发现错误或有功能请求,请通过在 GitHub Issues 中提交问题告知我们。
联系方式
Checkmarx One 集成团队
项目链接:https://github.com/Checkmarx/cx-agentic-ai。
网站:Checkmarx。
© 2026 Checkmarx Ltd. 版权所有。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。