convez.ai
MCP ServerSegurançaIntermediário
BG-QWQ

FindingBridge

BG-QWQ/FindingBridge

Centralize scanners de segurança e deixe a IA explicar o ruído

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor 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/FindingBridge

1 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

Estrelas
4
Forks
1
Acompanhando
0
Saúde
85%
Último commit
há 4 meses
Versão
v0.2.0
Issues abertas
1
Contribuidores
1

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.

npm version License: Apache-2.0 Quality Gate Status

🤔 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)

  1. Download the release for your platform from Releases
  2. Extract and run findingbridge (or findingbridge.exe on Windows)
  3. Follow the web setup wizard at http://localhost:3456/setup
  4. 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

ScannerStatusInput
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:

ToolDescriptionRead-Only
findingbridge_list_findingsList findings with filters and pagination✅
findingbridge_get_finding_detailGet full finding details + code context✅
findingbridge_explain_findingExplain a finding in plain language✅
findingbridge_suggest_fixGet remediation suggestions✅
findingbridge_prioritize_findingsRank findings by business impact✅
findingbridge_deduplicate_findingsPreview duplicate findings✅
findingbridge_generate_reportGenerate 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.

Ver o original no GitHub

Bom para

Relacionados