Black Duck Security Scanner

Black Duck MCP

Black Duck MCP 将 Signal 的 AI 驱动安全分析直接带入您的开发环境。它支持通过领先的编码助手（包括 Claude、Gemini、Cursor、Copilot 等）扫描代码，让您能够检测安全问题、获取可操作的见解，并快速、一致地应用建议的修复方案。

主要功能与优势

• 变更扫描：
  • 执行快速的增量安全扫描，仅关注开发者引入的代码变更。
  • 非常适合在编写代码的早期阶段检测问题
• 文件扫描：
  • 对特定文件或目录执行有针对性的安全分析。
  • 最适用于不使用 Git 的项目，或希望分析代码库特定部分的开发者
• 跨平台支持：
  • 支持 Windows、macOS 和 Linux

要求

• Signal 许可证
• Node.js v24.0.0 或更高版本

入门

第 1 步：添加到 MCP 客户端

将以下配置添加到您的 MCP 客户端（此处以 Claude 用户级配置为例）：

{
  "mcpServers": {
    "black-duck-signal": {
      "command": "npx",
      "args": ["-y", "@black-duck/mcp-server"],
      "env": {
        "BLACKDUCK_MCP_GATEWAY_KEY": "your-api-key-here"
      }
    }
  }
}

第 2 步：执行首次扫描

在 MCP 客户端中使用以下任一提示词开始操作：

Scan my code changes for security vulnerabilities

您的 MCP 客户端应执行安全扫描，并报告在所做的代码变更中发现的任何漏洞。需要项目基于 Git，以确定哪些文件发生了变更。

Scan the changed files with respect to the main branch

您的 MCP 客户端应执行安全扫描，仅考虑当前分支相对于主分支的代码变更，并报告在所做的代码变更中发现的任何漏洞。需要项目基于 Git，以确定哪些文件发生了变更。

Scan all files under folder foobar for security vulnerabilities

您的 MCP 客户端应执行安全扫描，并报告发现的任何漏洞。

工具

工具	参数	返回值	最适用场景
run_changes_security_scan	projectPath（必需）：Git 项目的绝对路径 gitPatchMode（必需）： • all-uncommitted：扫描已暂存和未暂存的变更 • reference-branch：扫描自分支创建以来的变更 referenceBranch（可选）：参考分支名称（例如 main） scanEntireFileContent（可选）：为 true 时，扫描变更文件的全部内容，而不仅是变更行。默认值：false	• sarifFilePath：SARIF 报告路径 • status：success 或 failure • resourceUris：MCP 资源 URI • issueCounts：按严重程度统计的问题数量 • analysisGuidance：分析步骤	• 更快：仅分析变更的代码 • 更聚焦：显示您所做变更中的问题 • 适合迭代：非常适用于开发工作流和 CI/CD • 更高效：降低扫描成本并缩短耗时
run_security_scan	projectPath（必需）：项目的绝对路径 filePaths（必需）：要扫描的文件或目录绝对路径数组	• sarifFilePath：SARIF 报告路径 • status：success 或 failure • resourceUris：MCP 资源 URI • issueCounts：按严重程度统计的问题数量 • analysisGuidance：分析步骤	• 分析特定文件或目录 • 对关键路径进行有针对性的安全审查 • 开发期间快速检查 • 非 Git 项目

可选配置

Black Duck Signal MCP 服务支持以下环境变量：

变量	默认值	描述
BLACKDUCK_MCP_GATEWAY_KEY	无（必需）	用于增强 AI 分析的 API 密钥
BLACKDUCK_HOME	用户的主目录	覆盖默认的 .blackduck 文件夹位置
BLACKDUCK_MCP_TOOL_TIMEOUT	1800000（30 分钟）	扫描超时时间，单位为毫秒
BLACKDUCK_MCP_LOG_LEVEL	info	日志级别：error、warn、info 或 debug

您可以在 MCP 客户端配置中设置这些变量：

{
  "mcpServers": {
    "black-duck": {
      "command": "npx",
      "args": ["-y", "@black-duck/mcp-server"],
      "env": {
        "BLACKDUCK_MCP_GATEWAY_KEY": "your-api-key-here",
        "BLACKDUCK_MCP_LOG_LEVEL": "debug"
      }
    }
  }
}

日志与故障排除

日志位置

所有 MCP 日志均写入 /Users/<username>/.blackduck/mcp/logs/（适用于 linux/mac）以及 C:\Users\<Username>\AppData\Roaming\BlackDuck\mcp\logs\（可通过 BLACKDUCK_HOME 自定义）：

• black-duck-mcp.log - 汇总日志（所有级别）
• black-duck-mcp-error.log - 仅错误日志

IP 允许列表

MCP 服务正常运行需要能够访问以下 URL 和 IP 地址：

URL	IP 地址
repo.blackduck.com	34.149.5.115
llm.core.blackduck.com	104.18.36.253

确保防火墙允许向这些端点发起出站 HTTPS（端口 443）连接

许可证

本项目基于 MIT 许可证 授权。

资源

• 文档
• Black Duck Signal
• 联系我们
• 申请 SBOM