Checkmarx MCP

检查马克思mcp

Shell脚本和MCP服务器 Checkmarx One REST API。同一数据的两个接口：用自然语言（MCP）询问Claude，或运行可组合的CLI脚本以获得可重复的报告和管道。

这里有什么

快速开始

选项A:MCP服务器（与Claude一起使用）

cd mcp-server && npm install && npm run build

添加到Claude代码设置(.claude/settings.json):

{
  "mcpServers": {
    "checkmarx": {
      "command": "node",
      "args": ["/path/to/checkmarx-mcp/mcp-server/dist/index.js"],
      "env": {
        "CHECKMARX_TENANT": "your-tenant",
        "CHECKMARX_BASE_URI": "https://ast.checkmarx.net",
        "CHECKMARX_API_KEY": "your-api-key"
      }
    }
  }
}

然后问克劳德： *“我所有项目的安全状况如何？”*

选项B:CLI脚本

cp .env.example .env   # fill in your credentials
./utils/checkmarx.list-projects.sh | jq '.[].name'

看 CLAUDE.md 获取完整的CLI文档。

你能用这个做什么

项目库存和状态报告

在一次通话中获取每个项目的最后一次扫描状态——无需再点击门户：

# Via CLI: all projects for an application with their last scan info
./utils/checkmarx.list-projects-last-scan.sh --application-id "$APP_ID"

# Via Claude: "Show me all projects in the OneApp application with their scan status"

漏洞摘要和分布

按严重性、语言、查询类型或文件细分结果：

# Top 10 SAST vulnerability types for a scan
./utils/checkmarx.sast-aggregate.sh --scan-id "$SID" --group-by QUERY --limit 10

# Severity distribution
./utils/checkmarx.sast-aggregate.sh --scan-id "$SID" --group-by SEVERITY

扫描比较（“发生了什么变化？”）

比较两次扫描，查看新的、固定的和复发的发现：

./utils/checkmarx.sast-compare.sh --scan-id "$NEW_SID" --base-scan-id "$OLD_SID" --group-by QUERY

随时间变化的趋势分析

按月度、季度或年度粒度跟踪严重性计数和净变化：

# Severity trend for a project over the last 6 months
./utils/checkmarx.trend-severity.sh --project-id "$PID" --period monthly --range 6

# Net change (are we introducing faster than fixing?) — quarterly for an entire app
./utils/checkmarx.trend-new-vs-fixed.sh --application-id "$APP_ID" --period quarterly --range 4

# Filter to specific engines
./utils/checkmarx.trend-severity.sh --project-id "$PID" --period monthly --range 12 --engines sast,sca

# Via Claude: "Show me the severity trend for MyApp over the last year, quarterly"

分类和合规状态

检查分流历史记录，并通过查找生命周期进行筛选：

# Only new (untriaged) findings
./utils/checkmarx.list-results.sh --scan-id "$SID" --status "NEW" --severity "HIGH,CRITICAL"

# Triage history for a specific finding
./utils/checkmarx.get-sast-predicates.sh --similarity-id "12345"

输出格式

所有脚本输出 原始JSON 到stdout。不生成可视化图表或Excel文件——脚本生成结构化数据，您可以将其路由到任何需要的地方：

# JSON (default) — pipe to jq, files, or dashboards
./utils/checkmarx.trend-severity.sh --project-id "$PID" --period monthly --range 6 > trend.json

# CSV for Excel — open in spreadsheets, build charts there
source lib.sh
./utils/checkmarx.trend-severity.sh --project-id "$PID" --period monthly --range 6 \
  | jq '[.[] | {period, critical: .total.critical, high: .total.high, medium: .total.medium}]' \
  | cx_format_csv .period .critical .high .medium > severity-trend.csv

# Markdown table — paste into Slack or Confluence
./utils/checkmarx.trend-new-vs-fixed.sh --project-id "$PID" --period quarterly --range 4 \
  | jq '[.[] | {period, net: .total.net_change}]' \
  | cx_format_table .period .net

# Via Claude (MCP): "Show me the severity trend for MyApp, quarterly, as a table"
# Claude calls trend_severity, gets JSON, formats it however you ask

Power BI仪表板

生成完整的数据包并导入Power BI：

# Generate CSVs for an application
./utils/checkmarx.generate-report-data.sh --application-id "$APP_ID"
# Output: ~/Downloads/checkmarx-reports/2026-03-30/trend-severity.csv, trend-new-vs-fixed.csv, metadata.json
# (Falls back to ~/checkmarx-reports/ on headless Linux)

# Open in Power BI Desktop: Get Data > Text/CSV > select the files
# See reports/powerbi-setup.md for step-by-step dashboard configuration

MCP工具返回JSON——Claude以对话方式处理格式化（“使其成为CSV”、“在表中总结”）。

MCP服务器工具（18）

项目和库存

扫描

结果与发现

SAST分析

趋势与报告

组织

报告

CLI脚本（19）

每个脚本将JSON输出到stdout，将日志记录到stderr，并支持 -v/--verbose.

所有脚本名称都以前缀 checkmarx. （例如。， ./utils/checkmarx.list-projects.sh).

配置

CLI脚本和MCP服务器都需要Checkmarx One凭据：

\*提供API密钥 或 客户端ID+密码。

区域基础URL

先决条件

• CLI脚本： curl, jq，巴什
• MCP服务器： Node.js>=18

许可证

麻省理工学院