Black Duck Security Scanner MCP server
Commit Sep 2, 2026Enables AI coding assistants to perform incremental or targeted security scans to detect vulnerabilities and receive actionable fixes.
Also known as blackducksoftware/mcp-server, mcp-server, @black-duck/mcp-server
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- 889
- Latest version
- 1.1.8
- Last commit
- Sep 2, 2026
- License
- MIT
What is Black Duck Security Scanner MCP?
Black Duck Security Scanner enables AI coding assistants to perform incremental or targeted security scans to detect vulnerabilities and receive actionable fixes.
Summary generated from the project's README
About Black Duck Security Scanner MCP server
Black Duck MCP integrates Signal security analysis into coding assistants like Claude, Gemini, Cursor, and Copilot. It allows developers to perform security scans directly within their development environment on Windows, macOS, or Linux. The server requires a Signal License and Node.js version 24.0.0 or newer to function. Users must provide a BLACKDUCK_MCP_GATEWAY_KEY in their client configuration to enable enhanced AI analysis.
Developers can choose between two primary scanning methods. The run_changes_security_scan tool provides incremental analysis for Git-based projects by focusing on uncommitted changes or differences between branches. Alternatively, the run_security_scan tool allows for targeted analysis of specific files or directories, making it suitable for non-Git projects. Both tools return SARIF reports, issue counts by severity, and guidance for fixing vulnerabilities.
What you can do with it
- 1Scan uncommitted code changesAsk the AI to check your current staged or unstaged code for security vulnerabilities before committing.
- 2Analyze specific project directoriesDirect the assistant to run a security review on a particular folder or set of files.
- 3Compare branch security differencesIdentify security issues introduced by comparing your current branch against the main branch.
Written from the project's README. Every use case is checked against a quote from it.
How to install Black Duck Security Scanner MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Black Duck Security Scanner MCP in Claude Code
$ claude mcp add mcp-server -- npx -y @black-duck/mcp-serverInstall Black Duck Security Scanner MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@black-duck/mcp-server"
]
}
}
}Install Black Duck Security Scanner MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@black-duck/mcp-server"
]
}
}
}Install Black Duck Security Scanner MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@black-duck/mcp-server"]}'Install Black Duck Security Scanner MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@black-duck/mcp-server"
]
}
}
}Install Black Duck Security Scanner MCP in Codex
$ codex mcp add mcp-server -- npx -y @black-duck/mcp-serverInstall Black Duck Security Scanner MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@black-duck/mcp-server"]
Install Black Duck Security Scanner MCP in Gemini CLI
$ gemini mcp add -s user mcp-server npx -- -y @black-duck/mcp-serverInstall Black Duck Security Scanner MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@black-duck/mcp-server"
]
}
}
}Configuration
BLACKDUCK_MCP_GATEWAY_KEYBLACKDUCK_MCP_LOG_LEVEL
| Name | Description | |
|---|---|---|
| BLACKDUCK_MCP_GATEWAY_KEY | — | |
| BLACKDUCK_MCP_LOG_LEVEL | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableblackducksoftware/mcp-server is public and reachablegithub.com/blackducksoftware/mcp-server ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-02github.com/blackducksoftware/mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @black-duck/mcp-serverPass
- No critical advisory in the package or its dependenciesCritical advisory: GHSA-x6jw-m9v5-85vh, GHSA-v5rq-49vh-5v5cosv.dev/vulnerability/GHSA-x6jw-m9v5-85vh ↗Finding
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubBlack Duck MCP
Black Duck MCP brings Signal's AI-powered security analysis directly into your development environment. It enables code scanning through leading coding assistants – including Claude, Gemini, Cursor, Copilot, and others – so you can detect security issues, receive actionable insights, and apply recommended fixes quickly and consistently.
Key Features & Benefits
- Changes Scan:
- Performs fast, incremental security scans focused only on the code changes introduced by the developer.
- Ideal for early-stage detection of issues as code is written
- File Scan:
- Runs a targeted security analysis on specific files or directories.
- Best suited for projects that do not use Git or for developers who want to analyze specific portions of the codebase
- Cross-Platform Support:
- Works on Windows, macOS, and Linux
Requirements
- Signal License
- Node.js v24.0.0 or newer
Getting started
Step 1: Add to your MCP client
Add the following configuration to your MCP client (using Claude user level config as example):
{
"mcpServers": {
"black-duck-signal": {
"command": "npx",
"args": ["-y", "@black-duck/mcp-server"],
"env": {
"BLACKDUCK_MCP_GATEWAY_KEY": "your-api-key-here"
}
}
}
}
Step 2: Your first scan
Use one of following prompts in your MCP client to get you started:
Scan my code changes for security vulnerabilities
Your MCP client should execute a security scan and report any vulnerabilities found on the code changes made. Requires that the project is git based to determine what files have changed.
Scan the changed files with respect to the main branch
Your MCP client should execute a security scan taking into account only code changes in the current branch vs the main branch and report any vulnerabilities found on the code changes made. Requires that the project is git based to determine what files have changed.
Scan all files under folder foobar for security vulnerabilities
Your MCP client should execute a security scan and report any vulnerabilities found.
Tools
| Tool | Parameters | Returns | Best Use Cases |
|---|---|---|---|
run_changes_security_scan |
projectPath (required): Absolute path to git projectgitPatchMode (required):• all-uncommitted: Scan staged + unstaged changes• reference-branch: Scan changes since branchingreferenceBranch (optional): Reference branch name (e.g., main)scanEntireFileContent (optional): When true, scans entire content of changed files instead of just changed lines. Default: false |
• sarifFilePath: Path to SARIF report• status: success or failure• resourceUris: MCP resource URIs• issueCounts: Counts by severity• analysisGuidance: Analysis steps |
• Faster: Analyzes only changed code• Focused: Shows issues from your changes• Iterative: Perfect for dev workflows & CI/CD• Efficient: Reduces scan cost and time |
run_security_scan |
projectPath (required): Absolute path to projectfilePaths (required): Array of file/directory absolute paths to scan |
• sarifFilePath: Path to SARIF report• status: success or failure• resourceUris: MCP resource URIs• issueCounts: Counts by severity• analysisGuidance: Analysis steps |
• Analyzing specific files/directories• Focused security review of critical paths• Quick checks during development• Non-git projects |
Optional Configuration
The Black Duck Signal MCP server supports the following environment variables:
| Variable | Default | Description |
|---|---|---|
BLACKDUCK_MCP_GATEWAY_KEY |
None (required) | API key for enhanced AI analysis |
BLACKDUCK_HOME |
User's home directory | Override the default .blackduck folder location |
BLACKDUCK_MCP_TOOL_TIMEOUT |
1800000 (30 min) |
Scan timeout in milliseconds |
BLACKDUCK_MCP_LOG_LEVEL |
info |
Log level: error, warn, info, or debug |
You can set these variables in your MCP client configuration:
{
"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"
}
}
}
}
Logging and Troubleshooting
Log Location
All MCP logs are written to /Users/<username>/.blackduck/mcp/logs/ for linux/mac and C:\Users\<Username>\AppData\Roaming\BlackDuck\mcp\logs\ (customizable via BLACKDUCK_HOME):
black-duck-mcp.log- Combined log (all levels)black-duck-mcp-error.log- Error-only log
IP Allowlist
The following URLs and IP addresses must be accessible for the MCP server to function properly:
| URL | IP Address |
|---|---|
repo.blackduck.com |
34.149.5.115 |
llm.core.blackduck.com |
104.18.36.253 |
Ensure your firewall allows outbound HTTPS (port 443) connections to these endpoints
License
This project is licensed under the MIT License.
Resources
Black Duck Security Scanner MCP questions
How do I add Black Duck Security Scanner MCP to Claude Code?
Run claude mcp add mcp-server -- npx -y @black-duck/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Black Duck Security Scanner MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can I scan specific files or directories?
Yes, the run_security_scan tool allows you to run a targeted security analysis on specific files or directories.
How can I scan only the code changes I have made?
You can use the run_changes_security_scan tool, which performs fast, incremental security scans focused only on the code changes introduced by the developer.
Does the server support Windows, macOS, and Linux?
Yes, it provides cross-platform support for Windows, macOS, and Linux.