Black Duck Security Scanner MCP server
2026년 9월 2일 커밋AI 코딩 어시스턴트가 취약점을 탐지하고 실행 가능한 수정 방안을 받을 수 있도록 증분 또는 타겟 보안 스캔을 수행합니다.
다른 이름 blackducksoftware/mcp-server, mcp-server, @black-duck/mcp-server
- 스타
- 1
- Tools
- —
- 다운로드, 30일
- 889
- 최신 버전
- 1.1.8
- 마지막 커밋
- 2026년 9월 2일
- 라이선스
- MIT
Black Duck Security Scanner MCP란?
AI 코딩 어시스턴트가 취약점을 탐지하고 실행 가능한 수정 방안을 받을 수 있도록 증분 또는 타겟 보안 스캔을 수행합니다.
프로젝트 README에서 생성된 요약
Black Duck Security Scanner MCP server 정보
Black Duck MCP는 Signal 보안 분석 기능을 Claude, Gemini, Cursor, Copilot과 같은 코딩 어시스턴트에 통합합니다. 개발자는 Windows, macOS 또는 Linux 환경의 개발 환경 내에서 직접 보안 스캔을 수행할 수 있습니다. 이 MCP server를 작동하려면 Signal License와 Node.js 24.0.0 이상의 버전이 필요합니다. 향상된 AI 분석을 활성화하려면 클라이언트 설정에 BLACKDUCK_MCP_GATEWAY_KEY를 제공해야 합니다.
개발자는 두 가지 주요 스캔 방식 중 하나를 선택할 수 있습니다. run_changes_security_scan 도구는 커밋되지 않은 변경 사항이나 브랜치 간의 차이점에 집중하여 Git 기반 프로젝트에 대한 증분 분석을 제공합니다. 또는 run_security_scan 도구를 사용하여 특정 파일이나 디렉토리에 대한 타겟 분석을 수행할 수 있어 Git을 사용하지 않는 프로젝트에도 적합합니다. 두 도구 모두 SARIF 보고서, 심각도별 이슈 수, 취약점 수정을 위한 가이드를 반환합니다.
활용 사례
- 1커밋되지 않은 코드 변경 사항 스캔커밋하기 전에 현재 스테이징되었거나 스테이징되지 않은 코드의 보안 취약점을 AI에게 확인하도록 요청합니다.
- 2특정 프로젝트 디렉토리 분석어시스턴트에게 특정 폴더 또는 파일 세트에 대해 보안 검토를 수행하도록 지시합니다.
- 3브랜치 간 보안 차이 비교현재 브랜치를 main 브랜치와 비교하여 새롭게 발생한 보안 이슈를 식별합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Black Duck Security Scanner MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Black Duck Security Scanner MCP 설치
$ claude mcp add mcp-server -- npx -y @black-duck/mcp-serverCursor에 Black Duck Security Scanner MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@black-duck/mcp-server"
]
}
}
}VS Code에 Black Duck Security Scanner MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@black-duck/mcp-server"
]
}
}
}VS Code CLI에 Black Duck Security Scanner MCP 설치
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@black-duck/mcp-server"]}'Claude Desktop에 Black Duck Security Scanner MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@black-duck/mcp-server"
]
}
}
}Codex에 Black Duck Security Scanner MCP 설치
$ codex mcp add mcp-server -- npx -y @black-duck/mcp-serverCodex config.toml에 Black Duck Security Scanner MCP 설치
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@black-duck/mcp-server"]
Gemini CLI에 Black Duck Security Scanner MCP 설치
$ gemini mcp add -s user mcp-server npx -- -y @black-duck/mcp-serverGemini settings.json에 Black Duck Security Scanner MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@black-duck/mcp-server"
]
}
}
}구성
BLACKDUCK_MCP_GATEWAY_KEYBLACKDUCK_MCP_LOG_LEVEL
| 이름 | 설명 | 유형 |
|---|---|---|
| BLACKDUCK_MCP_GATEWAY_KEY | — | |
| BLACKDUCK_MCP_LOG_LEVEL | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능blackducksoftware/mcp-server is public and reachablegithub.com/blackducksoftware/mcp-server ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-09-02github.com/blackducksoftware/mcp-server ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @black-duck/mcp-server통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음Critical advisory: GHSA-x6jw-m9v5-85vh, GHSA-v5rq-49vh-5v5cosv.dev/vulnerability/GHSA-x6jw-m9v5-85vh ↗결함 발견
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Black 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 질문
Black Duck Security Scanner MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add mcp-server -- npx -y @black-duck/mcp-server를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Black Duck Security Scanner MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
특정 파일이나 디렉토리를 스캔할 수 있나요?
네, run_security_scan 도구를 사용하여 특정 파일이나 디렉토리에 대해 타겟 보안 분석을 수행할 수 있습니다.
제가 수정한 코드 변경 사항만 스캔하려면 어떻게 해야 하나요?
run_changes_security_scan 도구를 사용하면 개발자가 도입한 코드 변경 사항에만 집중하여 빠르고 증분적인 보안 스캔을 수행할 수 있습니다.
Windows, macOS, Linux를 지원하나요?
네, Windows, macOS, Linux를 모두 지원하는 크로스 플랫폼 환경을 제공합니다.