FindingBridge
BG-QWQ/FindingBridge
Centralize scanners de segurança e deixe a IA explicar o ruído
Ver no GitHubServidor MCP que centraliza alertas de scanners de código (SonarCloud, GitHub Code Scanning, SARIF, Snyk, Semgrep) e expõe ferramentas para agentes de IA triarem, explicarem e priorizarem vulnerabilidades. Prioriza privacidade com dados locais e oferece uma experiência amigável para iniciantes.
Instalação
npx convez-ai BG-QWQ/FindingBridge1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Triagem de vulnerabilidades e problemas de código
- Explicação em linguagem natural de alertas técnicos de segurança
- Priorização de achados por impacto no negócio
- Deduplicação e consolidação de alertas de múltiplos scanners
- Geração de relatórios de segurança
Veredito

Solução prática que resolve um problema real: a fragmentação de alertas de segurança. Bem-arquitetada com foco em privacidade local e integração agnóstica com múltiplos scanners, facilitando triagem assistida por IA de forma simples.
README
A tradução para o português deste README ainda está na fila.
FindingBridge 🌉
Connect your scanners. Let AI explain the noise.
🤔 Why FindingBridge?
As a developer, you’ve probably been overwhelmed by security scanner alerts. SonarCloud, GitHub Code Scanning, Semgrep, Trivy — each has its own interface, severity levels, and jargon. FindingBridge connects these scanners and exposes their findings through MCP (Model Context Protocol) tools, so your AI assistant can help you understand, prioritize, and fix them.
Key principles:
- Scanner-agnostic: Not locked to any single scanner
- Privacy-first: Data stays local (SQLite by default)
- MCP-native: Works with Claude, Cursor, and any MCP client
- Open source: Self-hosted, no SaaS lock-in
✨ 3-Minute Quick Start
Method 1: Download & Run (Recommended for beginners)
- Download the release for your platform from Releases
- Extract and run
findingbridge(orfindingbridge.exeon Windows) - Follow the web setup wizard at
http://localhost:3456/setup - Ask Claude: "What are my most critical security findings?"
Method 2: npm (For developers)
npx findingbridge@latest server
# First run automatically opens the setup wizard
Method 3: Zero-Config Demo
npx findingbridge@latest server --demo
# Pre-loaded sample findings for instant exploration
🔌 Supported Scanners
| Scanner | Status | Input |
|---|---|---|
| SARIF files | ✅ | Local file path |
| GitHub Code Scanning | ✅ | Personal Access Token |
| SonarCloud | ✅ | User Token |
| Socket.dev | 🚧 | Planned for v0.2 |
| Snyk | 🚧 | Planned for v0.2 |
| Semgrep | 🚧 | Planned for v0.2 |
🛠️ MCP Tools
All tools use the findingbridge_ prefix:
| Tool | Description | Read-Only |
|---|---|---|
findingbridge_list_findings | List findings with filters and pagination | ✅ |
findingbridge_get_finding_detail | Get full finding details + code context | ✅ |
findingbridge_explain_finding | Explain a finding in plain language | ✅ |
findingbridge_suggest_fix | Get remediation suggestions | ✅ |
findingbridge_prioritize_findings | Rank findings by business impact | ✅ |
findingbridge_deduplicate_findings | Preview duplicate findings | ✅ |
findingbridge_generate_report | Generate Markdown/HTML report | ✅ |
🖥️ CLI Commands
findingbridge init # Initialize configuration
findingbridge setup # Run guided setup wizard
findingbridge setup --cli # CLI fallback (no browser)
findingbridge ingest --sarif <path> # Import SARIF file
findingbridge server # Start MCP server
findingbridge server --demo # Start with demo data
findingbridge config show # Show current config
findingbridge config test # Test scanner connections
findingbridge diagnose # Generate diagnostic report
🏗️ Architecture
┌─────────────────────────────────────────┐
│ LLM Agent (Claude / Cursor / Copilot) │
└─────────────────┬───────────────────────┘
│ MCP Protocol (stdio)
┌─────────────────▼───────────────────────┐
│ FindingBridge MCP Server │
│ - 7 read-only tools │
│ - Structured JSON outputs │
└─────────────────┬───────────────────────┘
│
┌─────────────────▼───────────────────────┐
│ Core Engine │
│ - Normalization (severity mapping) │
│ - Deduplication (fingerprinting) │
│ - Prioritization (scoring) │
│ - Reporting (Markdown/HTML) │
└─────────────────┬───────────────────────┘
│
┌─────────────────▼───────────────────────┐
│ Adapters │
│ - SARIF File Reader │
│ - GitHub Code Scanning API │
│ - SonarCloud API │
└─────────────────┬───────────────────────┘
│
┌─────────────────▼───────────────────────┐
│ SQLite (default) / PostgreSQL (opt) │
└─────────────────────────────────────────┘
🔒 Privacy & Security
- Data stays local: SQLite database in
~/.findingbridge/ - Token storage: System keychain (keytar) with env fallback
- No source upload: Only finding metadata + 20-line code snippets
- Secret redaction: Automatic redaction in logs and responses
- Read-only: No tools modify your repositories
📄 Documentation
🤝 Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
📄 License
Apache License 2.0 — see LICENSE for details.