Scanner de segurança com IA em primeiro lugar. NOVO na v2026.7: detecção de comprometimento do Claude Code — verifique hooks, permissões e skills em `.claude/` antes de clonar — além de um scanner de assinaturas de ataques de IA sempre ativo e regras nativas em Rust e PHP. Também: `medusa scan --git` para verificar qualquer repositório, `medusa secrets scan` para chaves de API vazadas. Mais de 40.000 padrões, zero configuração.
Scanner de segurança com foco em IA com mais de 40.000 padrões de detecção para aplicações de IA/ML, agentes e LLM.
🤖 Funciona pronto para uso - nenhuma instalação de ferramentas é necessária.
🚨 200 CVEs: Log4Shell, Spring4Shell, XZ Utils, LangChain RCE, MCP-Remote RCE, React2Shell
🔥 medusa scan --git <URL> — Examine qualquer repositório em busca de ataques à cadeia de suprimentos de IA (envenenamento de repositório, injeção de prompt, envenenamento de ferramentas MCP)
🔐 medusa secrets scan — Encontre chaves de API vazadas no seu histórico de Claude / Cursor / Copilot / shell. 21 tipos de emissores. Redação interativa no local.
🚀 v2026.7.0: detecção de comprometimento do Claude Code, um scanner de assinaturas de ataques de IA sempre ativo, regras de segurança nativas para Rust e PHP e diagnósticos em nível de regra — além de mais de 40.000 padrões de detecção.
A MEDUSA é um scanner de segurança com foco em IA com mais de 40.000 padrões de detecção que funciona pronto para uso. Basta instalar e escanear - nenhuma instalação de ferramentas externas é necessária. As regras integradas da MEDUSA detectam vulnerabilidades em aplicações de IA/ML, agentes de LLM, servidores MCP, pipelines de RAG e código tradicional.
medusa scan --git <URL> - Examine qualquer repositório do GitHub em busca de ataques à cadeia de suprimentos de IA em segundosmedusa secrets scan + purge - Encontre chaves de API / tokens / chaves privadas vazadas nos históricos de chat do Claude Code / Cursor / Copilot / Zed / Gemini e no seu histórico de REPL do bash / zsh / psql / mysql / python. 21 tipos de emissores (Anthropic, OpenAI, PyPI, PATs do GitHub, AWS, GCP, Stripe, Slack…). Purga interativa [y/n/s/a/q] com backup obrigatório byte-idêntico e redação compatível com JSONL. Apenas local, sem telemetria.pip install - nenhuma instalação de ferramentas necessária.medusa.yml para configurações específicas do projetoDetecção de cadeia de suprimentos no Claude Code, cobertura mais ampla de linguagens e observabilidade em nível de regra.
| Mudança | Detalhes | |
|---|---|---|
| 🛡️ | Detecção de comprometimento do Claude Code | medusa scan --git agora avalia estruturalmente .claude/ — hooks envenenados (curl|bash, base64→exec, exfiltração de credenciais, reverse shells), permissões excessivamente amplas (Bash(*), bypassPermissions), subagentes com ferramentas curinga e skills dropper — antes de você clonar. |
| 🎯 | Scanner de assinaturas de ataques sempre ativo | Fecha uma lacuna de falsos negativos — payloads de jailbreak / injeção de prompt em arquivos de dados (.jsonl/.csv) e prosa agora são detectados independentemente da confiança no contexto do LLM, além da recuperação de unicode invisível / bidi (Trojan Source, CVE-2021-42574). |
| 🦀 | Regras de segurança nativas para Rust | 22 regras prontas para uso (nenhum toolchain necessária) — verificação TLS desabilitada, injeção de comandos, desserialização não confiável, SQL bruto, operações de memória inseguras, criptografia fraca, SSRF. |
| 🐘 | Regras de segurança nativas para PHP | 16 regras prontas para uso — SQLi, injeção de comandos/eval, LFI/RFI, path traversal, injeção de objetos via unserialize(), upload irrestrito, XSS refletido, SSRF, criptografia fraca. |
| 🔬 | Diagnósticos de regras (--trace-rules) | Log de disparo por regra + cronometragem (rule-trace.jsonl, slow_rules.csv) e um heartbeat capaz de sobreviver a travamentos — encontrou e corrigiu um ReDoS real de backtracking catastrófico, além de um lint de ReDoS/conjunto aninhado que bloqueia padrões ruins no momento da autoria. |
| ⚡ | Mecanismo + precisão | Ganhos rápidos de desempenho no mecanismo de escaneamento, modo de triagem com consciência de contexto para avaliação de alvos --git, amostragem com limite de bytes para arquivos grandes e correção de falso positivo de segredos em placeholders de documentação. |
v2026.5.12 — Maior lançamento de padrões: 9.600 → 40.000+ padrões de detecção coletados de 8.466 artigos de pesquisa em segurança de IA, endurecido contra falsos positivos; scanner estrutural de integridade de regras.
v2026.5.10 — Endurecimento de segurança: correção de injeção de comando na extensão do VS Code, bug de achados em cache no --fail-on, correção de caminho obsoleto no cache de ferramentas, configurações MCP no diretório home do usuário agora são opt-in.
v2026.5.9 — Cobertura para comércio agêntico: UCPScanner + AP2Scanner + 45 regras de padrões positivos ajustadas manualmente.
v2026.5.8 — medusa secrets: escaneie históricos de chat de IA e de shell em busca de credenciais vazadas (21 tipos de emissores) com purga interativa [y/n/s/a/q].
v2026.5.7 — Regras de injeção de prompt indireta (101/102), scanner de importações na cadeia de suprimentos, correção de multiprocessamento no macOS/Windows.
v2026.5.5 — lançamento de endurecimento de segurança (defesas contra injeção de argv, SSRF via git, integridade do cache HMAC, correção de XSS em Markdown).
Linters Externos (opcionais): a MEDUSA detecta automaticamente bandit, eslint, shellcheck, etc. se estiverem instalados. Consulte o Guia de Ferramentas Opcionais.
O seu token do PyPI pode estar no seu histórico de chat do Claude agora mesmo.
Desenvolvedores colam chaves de API, tokens e credenciais em assistentes de IA todos os dias —
"implante isto com pypi-AgEI...", "use meu ghp_... para dar push", "a chave da AWS é AKIA...".
Os assistentes mantêm essas conversas em texto puro no disco. Qualquer pessoa com acesso de leitura
a $HOME — ou qualquer malware futuro com acesso ao shell — pode executar grep -r 'sk-\|ghp_\|AKIA' ~/
e coletar credenciais de produção em segundos.
medusa secrets scan as encontra. medusa secrets purge as remove.
medusa secrets scan
O conteúdo do chunk não foi fornecido na entrada. Não há texto para traduzir.```text
Scanning 118 file(s)...
── claude-code ──────────────────────────────────────────────
/home/ross/.claude/history.jsonl (13 finding(s))
[CRITICAL] Anthropic API key (anthropic)
/home/ross/.claude/history.jsonl:1005:13
sk-ant-api03***...***
[CRITICAL] PyPI API token (pypi)
/home/ross/.claude/history.jsonl:125:94
pypi-AgEIc***...***
[CRITICAL] GitHub fine-grained PAT (github)
/home/ross/.claude/history.jsonl:2306:13
github_pat_11A***...***
[HIGH] HuggingFace token (huggingface)
/home/ross/.claude/history.jsonl:3387:13
hf_JOi***...***
...
Total: 13 credentials across 1 file(s).
Report: /home/ross/.medusa/secrets-scan/secrets-20260519-074452.json
Em sua forma básica, o método `map_val` em si recebe um closure (a transformação)
que estamos aplicando a cada elemento. Mas como não está usando `self`, é um método
estático (no sentido de C FFI): não recebe uma referência a uma instância. Em
[`rlr::Value::map_val`] você pode ver que ele recebe apenas um argumento (o closure).```text
[CRITICAL] PyPI API token (pypi)
/home/ross/.claude/history.jsonl:125:94
pypi-AgEIc***...***
redact? [y/n/s/a/q/?]: y
[CRITICAL] Anthropic API key (anthropic)
/home/ross/.claude/history.jsonl:1005:13
sk-ant-api03***...***
redact? [y/n/s/a/q/?]: y
...
✓ /home/ross/.claude/history.jsonl (13 redacted)
backup → /home/ross/.medusa/secrets-scan/backups/20260519-074452/home/ross/.claude/history.jsonl
O arquivo original é copiado byte a byte antes de qualquer alteração. O JSONL permanece
analisável após a redação. O marcador de redação ([REDACTED-MEDUSA-...-<run-id>])
é único por execução, para que você possa rastreá-lo até o scan que o produziu.
medusa secrets scan # everything (default — chat + shell) medusa secrets scan --source ai-chats # AI assistants only medusa secrets scan --source shell # ~/.bash_history, ~/.zsh_history, fish, psql, mysql, ... medusa secrets scan --path FILE # explicit file (e.g. a ChatGPT export) medusa secrets scan --reveal # show real values (requires 'I UNDERSTAND')
medusa secrets purge # interactive [y/n/s/a/q] medusa secrets purge SCAN_ID # purge a specific report medusa secrets purge --all --yes-i-know # batch mode for power users / CI
### O que é detectado (21 emissores)
**Provedores de IA**: Anthropic, OpenAI, HuggingFace, Replicate, Cohere
**Registros de pacotes**: PyPI, npm
**Plataformas de código-fonte**: GitHub PAT (clássico + fine-grained + OAuth + App), GitLab PAT
**Nuvem**: AWS access keys, GCP service-account JSON
**Pagamentos / comunicações**: Stripe live/restricted keys, Slack bot/user tokens, SendGrid, Twilio, Discord webhooks
**Criptografia**: chaves privadas codificadas em PEM (RSA, DSA, EC, OpenSSH, PGP)
### Propriedades de segurança
- **Somente local.** Relatórios em `~/.medusa/secrets-scan/` com modo `0o600`. Sem rede, sem telemetria, nunca gravados nas árvores do projeto.
- **Backup antes de gravar.** Toda redação é precedida por um backup byte-idêntico. `cp` o restaura.
- **Compatível com JSONL.** O marcador de redação não contém caracteres incompatíveis com JSON; as linhas afetadas são reanalisadas após a gravação.
- **Recusa em caso de divergência.** Se o arquivo de origem mudou entre a varredura e a purga, o purgador recusa em vez de arriscar sobrescrever uma edição.
- **Gravação atômica.** Arquivo temporário + substituição via `os.replace`. Ou a reescrita é aplicada ou o original permanece.
[**📖 Guia completo do scanner de segredos →**](https://github.com/pantheon-security/medusa/blob/main/docs/SECRETS_SCANNER.md)
---
## 🚀 Início Rápido
### Instalação```bash
# Install MEDUSA (works on Windows, macOS, Linux)
pip install medusa-security
# Run your first scan - that's it!
medusa scan .
Ambiente Virtual (Recomendado):```bash
python3 -m venv medusa-env source medusa-env/bin/activate # On Windows: medusa-env\Scripts\activate
pip install medusa-security medusa scan .
**Notas de plataforma:**
- **Windows**: Use `py -m medusa` se o comando `medusa` não for encontrado
- **macOS/Linux**: Deve funcionar de imediato
### Analise Qualquer Repositório do GitHub```bash
# Scan a remote repo for AI supply chain attacks
medusa scan --git https://github.com/org/repo
# Shorthand - just user/repo
medusa scan --git org/repo
# Scan a specific branch
medusa scan --git https://github.com/org/repo/tree/main
A MEDUSA detecta automaticamente mais de 28 arquivos de configuração de editores de IA que são vetores de ataque conhecidos:
| Nível de Risco | Arquivos Detectados |
|---|---|
| Crítico (RCE) | .cursorrules, .cursor/mcp.json, .clinerules/, .windsurfrules, .codex/config.toml, .kiro/settings/mcp.json, .vscode/settings.json, mcp.json |
| Alto | CLAUDE.md, GEMINI.md, AGENTS.md, AGENT.md, SKILL.md, .github/copilot-instructions.md, CONVENTIONS.md, .amazonq/rules/, .roo/rules/, .augment/rules/ |
Ataques conhecidos detectados: Clinejection, CurXecute (CVE-2025-54135), IDEsaster (CVE-2025-64660), ToxicSkills, CamoLeak, RoguePilot, AIShellJack, Cacheract
medusa install --ai-tools
### Opcional: Linters Externos
O MEDUSA detecta automaticamente linters externos se estiverem instalados (bandit, eslint, shellcheck, etc.) e os utiliza automaticamente para melhorar a cobertura de varredura.
**[Veja o Guia de Instalação →](https://github.com/pantheon-security/medusa/blob/main/docs/OPTIONAL_TOOLS.md)** para instruções específicas da plataforma.
> **Nota:** Os linters externos são opcionais. As mais de 40.000 regras integradas do MEDUSA funcionam sem eles. Para suporte à instalação, consulte a documentação de cada fornecedor da ferramenta.
### Demonstração
<div align="center">

</div>
### 📊 Formatos de Relatório
O MEDUSA gera relatórios bonitos em vários formatos:
**JSON** - Legível por máquina para integração com CI/CD```bash
medusa scan . --format json
HTML - UI glassmorphism deslumbrante com gráficos interativos```bash medusa scan . --format html
**Markdown** - Amigável para documentação no GitHub/wikis```bash
medusa scan . --format markdown
Todos os formatos - Gere tudo de uma vez```bash medusa scan . --format all
---
## 📚 Suporte a Linguagens
MEDUSA suporta **79 tipos de scanners** cobrindo segurança em IA/ML, todas as principais linguagens de programação e formatos de arquivo:
### Linguagens de Backend (9)
| Linguagem | Scanner | Extensões |
|----------|---------|------------|
| Python | Bandit | `.py` |
| JavaScript/TypeScript | ESLint | `.js`, `.jsx`, `.ts`, `.tsx` |
| Go | golangci-lint | `.go` |
| Ruby | RuboCop | `.rb`, `.rake`, `.gemspec` |
| PHP | regras nativas (+ PHPStan opcional) | `.php` |
| Rust | regras nativas (+ Clippy opcional) | `.rs` |
| Java | Checkstyle | `.java` |
| C/C++ | cppcheck | `.c`, `.cpp`, `.cc`, `.cxx`, `.h`, `.hpp` |
| C# | Roslynator | `.cs` |
### Linguagens JVM (3)
| Linguagem | Scanner | Extensões |
|----------|---------|------------|
| Kotlin | ktlint | `.kt`, `.kts` |
| Scala | Scalastyle | `.scala` |
| Groovy | CodeNarc | `.groovy`, `.gradle` |
### Linguagens Funcionais (5)
| Linguagem | Scanner | Extensões |
|----------|---------|------------|
| Haskell | HLint | `.hs`, `.lhs` |
| Elixir | Credo | `.ex`, `.exs` |
| Erlang | Elvis | `.erl`, `.hrl` |
| F# | FSharpLint | `.fs`, `.fsx` |
| Clojure | clj-kondo | `.clj`, `.cljs`, `.cljc` |
### Desenvolvimento Mobile (2)
| Linguagem | Scanner | Extensões |
|----------|---------|------------|
| Swift | SwiftLint | `.swift` |
| Objective-C | OCLint | `.m`, `.mm` |
### Frontend e Estilização (3)
| Linguagem | Scanner | Extensões |
|----------|---------|------------|
| CSS/SCSS/Sass/Less | Stylelint | `.css`, `.scss`, `.sass`, `.less` |
| HTML | HTMLHint | `.html`, `.htm` |
| Vue.js | ESLint | `.vue` |
### Infraestrutura como Código (4)
| Linguagem | Scanner | Extensões |
|----------|---------|------------|
| Terraform | tflint | `.tf`, `.tfvars` |
| Ansible | ansible-lint | `.yml` (playbooks) |
| Kubernetes | kubeval | `.yml`, `.yaml` (manifests) |
| CloudFormation | cfn-lint | `.yml`, `.yaml`, `.json` (templates) |
### Arquivos de Configuração (4)
| Linguagem | Scanner | Extensões |
|----------|---------|------------|
| JSON | integrado | `.json` |
| TOML | taplo | `.toml` |
| XML | xmllint | `.xml` |
| Protobuf | buf lint | `.proto` |
### Shell e Scripts (4)
| Linguagem | Scanner | Extensões |
|----------|---------|------------|
| Bash/Shell | ShellCheck | `.sh`, `.bash` |
| PowerShell | PSScriptAnalyzer | `.ps1`, `.psm1` |
| Lua | luacheck | `.lua` |
| Perl | perlcritic | `.pl`, `.pm` |
### Documentação (2)
| Linguagem | Scanner | Extensões |
|----------|---------|------------|
| Markdown | markdownlint | `.md` |
| reStructuredText | rst-lint | `.rst` |
### Outras Linguagens (5)
| Linguagem | Scanner | Extensões |
|----------|---------|------------|
| SQL | SQLFluff | `.sql` |
| R | lintr | `.r`, `.R` |
| Dart | dart analyze | `.dart` |
| Solidity | solhint | `.sol` |
| Docker | hadolint | `Dockerfile*` |
**Total: 79 tipos de scanners — 41 scanners de linguagens/ferramentas + 38 scanners de segurança IA/ML — cobrindo mais de 100 extensões de arquivo**
---
## 🚨 Detecção de CVE React2Shell (NOVO na v2025.8)
A MEDUSA agora detecta **CVE-2025-55182 "React2Shell"** - uma vulnerabilidade de RCE com CVSS 10.0 que afeta o React Server Components e o Next.js.```bash
# Check if your project is vulnerable
medusa scan .
# Vulnerable versions detected:
# - React 19.0.0 - 19.2.0 (Server Components)
# - Next.js 15.0.0 - 15.0.4 (App Router)
# - Various canary/rc releases
Varreduras: package.json, package-lock.json, yarn.lock, pnpm-lock.yaml
Correção: Atualize para React 19.0.1+ e Next.js 15.0.5+
A MEDUSA fornece varredura de segurança de IA líder do setor com 40.000+ padrões de detecção para a era da IA agêntica. Atualizada para o OWASP Top 10 para Aplicações LLM 2025 e inclui detecção para 200+ CVEs em editores de código de IA e servidores MCP.
| Categoria | Padrões | Detecta |
|---|---|---|
| Injeção de Prompt | 800+ | Injeção direta/indireta, jailbreaks, manipulação de papéis |
| Segurança de Servidor MCP | 400+ | Envenenamento de ferramenta, envenenamento de esquema, ATPA, injeção de amostragem, rug-pull |
| Envenenamento de Repositório | 150+ | Configurações de editores de IA armamentadas, Clinejection, CurXecute, IDEsaster, CamoLeak |
| Segurança RAG | 300+ | Injeção de vetor, envenenamento de documentos, isolamento de locatário |
| Segurança de Agentes | 500+ | Agência excessiva, envenenamento de memória, bypass de HITL |
| Segurança de Modelo | 400+ | Carregamento inseguro, exposição de checkpoints, ataques adversariais |
| Cadeia de Suprimentos | 350+ | Confusão de dependências, typosquatting, backdoors em arquivos lock |
| SAST Tradicional | 1.400+ | Injeção de SQL, XSS, injeção de comandos, segredos |
|
Ataques de Contexto e Entrada
Ataques de Memória e Estado
Ataques de Ferramentas e Ações
|
Ataques de Fluxo de Trabalho e Roteamento
Ataques RAG e de Conhecimento
Ataques Avançados
|
.cursorrules # Cursor AI (CVE-2025-54135) .cursor/rules/.mdc # Cursor rules directory .cursor/mcp.json # Cursor MCP (CurXecute RCE) .clinerules/.md # Cline (Clinejection) .windsurfrules # Windsurf (CVE-2025-36730) .windsurf/rules/* # Windsurf workspace rules .codex/config.toml # Codex CLI (CVE-2025-61260) .kiro/settings/mcp.json # Kiro (CVE-2026-0830) .vscode/settings.json # VS Code (IDEsaster) *.code-workspace # VS Code workspace mcp.json / .mcp.json # MCP server configs
CLAUDE.md # Claude Code GEMINI.md # Gemini CLI AGENTS.md # OpenAI Codex AGENT.md # Roo Code SKILL.md # ClawHub/ToxicSkills CONVENTIONS.md # Aider .github/copilot-instructions.md # GitHub Copilot .amazonq/rules/.md # Amazon Q Developer .augment/rules/ # Augment Code .roo/rules/.md # Roo Code .tabnine/guidelines/.md # Tabnine .continue/config.yaml # Continue.dev .cody.yml # Sourcegraph Cody
### Varredura Rápida de Segurança com IA```bash
# Scan AI configuration files
medusa scan . --ai-only
# Example output:
# 🔍 AI Security Scan Results
# ├── .cursorrules: 3 issues (1 CRITICAL, 2 HIGH)
# │ └── AIC001: Prompt injection - ignore previous instructions (line 15)
# │ └── AIC011: Tool shadowing - override default tools (line 23)
# ├── mcp-config.json: 2 issues (2 HIGH)
# │ └── MCP003: Dangerous path - home directory access (line 8)
# └── rag_config.json: 1 issue (1 CRITICAL)
# └── AIR010: Knowledge base injection pattern detected (line 45)
medusa init
medusa scan .
medusa scan /path/to/project
medusa scan . --quick
medusa scan . --force
medusa scan . --workers 4
medusa scan . --fail-on high
medusa scan . -o /tmp/reports
### Comandos de Instalação```bash
# Check tool status
medusa install --check
# Install AI tools (modelscan for ML model scanning)
medusa install --ai-tools
# Show detailed output
medusa install --ai-tools --debug
Nota: A partir do MEDUSA v2026.2+, linters externos não são mais instalados. Instale-os via seu gerenciador de pacotes (apt, brew, npm, pip), se necessário. O MEDUSA detecta e usa automaticamente quaisquer linters instalados.
medusa init
medusa init --ide claude-code
medusa init --ide claude-code --ide gemini-cli --ide cursor
medusa init --ide all
medusa init --force
medusa init --install
### Comandos Adicionais```bash
# Uninstall modelscan
medusa uninstall modelscan
# Check for updates
medusa version --check-updates
# Show current configuration
medusa config
# Override scanner for specific file
medusa override path/to/file.yaml YAMLScanner
# List available scanners
medusa override --list
# Show current overrides
medusa override --show
# Remove override
medusa override path/to/file.yaml --remove
| Opção | Descrição |
|---|---|
TARGET | Diretório ou arquivo para escanear (padrão: .) |
-g, --git URL | Clona e escaneia um repositório git remoto (URL do GitHub ou forma abreviada user/repo) |
-w, --workers N | Número de workers paralelos (padrão: detecção automática) |
--quick | Escaneamento rápido (apenas arquivos alterados, requer git) |
--force | Força escaneamento completo (ignora cache) |
--no-cache | Desativa o cache de resultados |
--fail-on LEVEL | Sai com erro na severidade: critical, high, medium, low |
-o, --output PATH | Diretório de saída personalizado para relatórios |
--format FORMAT | Formato de saída: json, html, sarif, junit, text (pode especificar vários) |
--no-report | Pula a geração do relatório HTML |
| Opção | Descrição |
|---|---|
--check | Verifica o status da ferramenta |
--ai-tools | Instala ferramentas de segurança para IA (modelscan) |
--debug | Mostra saída detalhada de depuração |
Alteração na v2026.2+: o MEDUSA não gerencia mais a instalação de linters externos. A flag
--allestá obsoleta. Instale linters externos via gerenciador de pacotes do seu sistema, se necessário.
.medusa.ymlO MEDUSA usa um arquivo de configuração YAML para configurações específicas do projeto:```yaml
version: 2026.5.5
scanners: enabled: [] # Empty = all scanners enabled disabled: [] # List scanners to disable
fail_on: high # critical | high | medium | low
exclude: paths: - node_modules/ - venv/ - .venv/ - .git/ - pycache/ - dist/ - build/ files: - ".min.js" - ".min.css"
ide: claude_code: enabled: true auto_scan: true cursor: enabled: false vscode: enabled: false
workers: null # null = auto-detect CPU cores cache_enabled: true # Enable file caching for speed
### Gerar Configuração Padrão```bash
medusa init
Isso cria um .medusa.yml com padrões sensatos e detecta automaticamente sua IDE.
O MEDUSA suporta 5 principais assistentes de codificação com IA com integrações nativas. Inicialize com medusa init --ide all ou selecione plataformas específicas.
| IDE | Arquivo de Contexto | Comandos | Status |
|---|---|---|---|
| Claude Code | CLAUDE.md | /medusa-scan, /medusa-install | ✅ Suporte Completo |
| Gemini CLI | GEMINI.md | /scan, /install | ✅ Suporte Completo |
| OpenAI Codex | AGENTS.md | Comandos slash nativos | ✅ Suporte Completo |
| GitHub Copilot | .github/copilot-instructions.md | Sugestões de código | ✅ Suporte Completo |
| Cursor | Reutiliza CLAUDE.md | Comandos MCP + Claude | ✅ Suporte Completo |
medusa init --ide all
medusa init --ide claude-code --ide gemini-cli
### Claude Code
**O que ele cria:**
- `CLAUDE.md` - Arquivo de contexto do projeto
- `.claude/agents/medusa/agent.json` - Configuração do agente
- `.claude/commands/medusa-scan.md` - Comando slash de scan
- `.claude/commands/medusa-install.md` - Comando slash de instalação
**Uso:**```
Type: /medusa-scan
Claude: *runs security scan*
Results: Displayed in terminal + chat
O que cria:
GEMINI.md - Arquivo de contexto do projeto.gemini/commands/scan.toml - Configuração do comando scan.gemini/commands/install.toml - Configuração do comando installUso:```bash gemini /scan # Full scan gemini /scan --quick # Quick scan gemini /install --check # Check tools
### OpenAI Codex
**O que ele cria:**
- `AGENTS.md` - Contexto do projeto (nível raiz)
**Uso:**```
Ask: "Run a security scan"
Codex: *executes medusa scan .*
O que ele cria:
.github/copilot-instructions.md - Padrões de segurança e boas práticasComo ele ajuda:
O que ele cria:
.cursor/mcp-config.json - Configuração do servidor MCP.claude/ (Cursor é um fork do VS Code)Uso:
O MEDUSA monitora automaticamente a carga do sistema e ajusta a quantidade de workers:```python
⚠️ High CPU usage: 85.3% Using 2 workers (reduced due to system load)
### Cache Inteligente
O cache baseado em hash ignora arquivos inalterados:```bash
# First scan
📂 Files scanned: 145
⏱️ Total time: 47.28s
# Second scan (no changes)
📂 Files scanned: 0
⚡ Files cached: 145
⏱️ Total time: 2.15s # 22× faster!
Varredura multi-core para ganhos massivos de velocidade:``` Single-threaded: 417.5 seconds 6 workers: 47.3 seconds # 8.8× faster 24 workers: ~18 seconds # 23× faster
---
## 📊 Exemplo de Fluxo de Trabalho
### Configuração de Novo Projeto```bash
# 1. Initialize
cd my-awesome-project
medusa init
🐍 MEDUSA Initialization Wizard
✅ Step 1: Project Analysis
Found 15 language types
Primary: PythonScanner (44 files)
✅ Step 2: Scanner Availability
Available: 6/79 scanners
Missing: 73 tools
✅ Step 3: Configuration
Created .medusa.yml
Auto-detected IDE: Claude Code
✅ Step 4: IDE Integration
Created .claude/agents/medusa/agent.json
Created .claude/commands/medusa-scan.md
✅ MEDUSA Initialized Successfully!
# 2. First scan
medusa scan .
🔍 Issues found: 23
CRITICAL: 0
HIGH: 2
MEDIUM: 18
LOW: 3
# 3. Fix issues and rescan
medusa scan . --quick
⚡ Files cached: 142
🔍 Issues found: 12 # Progress!
name: Security Scan
on: [push, pull_request]
jobs: medusa: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3
- name: Set up Python
uses: actions/setup-python@v4
with:
python-version: '3.11'
- name: Install MEDUSA
run: pip install medusa-security
- name: Run security scan
run: medusa scan . --fail-on high
> **Nota**: Nenhuma etapa de instalação de ferramenta necessária - as mais de 40.000 regras integradas da MEDUSA funcionam imediatamente.
---
## 🏗️ Arquitetura
### Padrão do Scanner
Todos os scanners seguem um padrão consistente:```python
class PythonScanner(BaseScanner):
"""Scanner for Python files using Bandit"""
def get_tool_name(self) -> str:
return "bandit"
def get_file_extensions(self) -> List[str]:
return [".py"]
def scan_file(self, file_path: Path) -> ScannerResult:
# Run bandit on file
# Parse JSON output
# Map severity levels
# Return structured issues
return ScannerResult(...)
Os scanners se registram automaticamente:```python
registry = ScannerRegistry() registry.register(PythonScanner()) registry.register(JavaScriptScanner())
### Mapeamento de Severidade
Níveis de severidade unificados em todas as ferramentas:
- **CRITICAL** - Vulnerabilidades de segurança, erros fatais
- **HIGH** - Erros, avisos de segurança
- **MEDIUM** - Avisos, problemas de qualidade de código
- **LOW** - Problemas de estilo, convenções
- **INFO** - Sugestões, oportunidades de refatoração
---
## 🧪 Testes e Qualidade
### Resultados de Dogfooding
MEDUSA escaneia a si mesma — e projetos do mundo real:```
Self-scan (473 files):
✅ Issues found: 114 (pre-filter) → 0 (post-filter)
✅ FP reduction: 100% on own codebase
⏱️ Time: 8.2s
OpenClaw benchmark (4,124 files, 751K LOC):
🔍 Issues found: 825 (post-filter)
✅ FPs filtered: 11,436 (93.9% reduction)
⏱️ Time: 3.3 hours (79 scanners)
| Tamanho do Projeto | Arquivos | Tempo | Velocidade |
|---|---|---|---|
| Pequeno (autoverificação do MEDUSA) | 473 | ~8s | 59 arquivos/s |
| Médio | 1.000 | ~45s | 22 arquivos/s |
| Grande (OpenClaw) | 4.124 | ~3,3h | 0,34 arquivos/s* |
*O tempo em projetos grandes é dominado por subprocessos de ferramentas externas (Semgrep, Trivy, GitLeaks). A varredura de padrões integrada é quase instantânea.
medusa scan --git <URL> - Analisar qualquer repositório GitHub em busca de ataques à cadeia de suprimentos de IAAceitamos contribuições! Veja como começar:```bash
git clone https://github.com/yourusername/medusa.git cd medusa
python -m venv .venv
source .venv/bin/activate # or .venv\Scripts\activate on Windows
pip install -e ".[dev]"
pytest
git checkout -b feature/my-awesome-feature
medusa scan . # Dogfood your changes!
git push origin feature/my-awesome-feature
### Adicionando Novos Scanners
Consulte `docs/development/adding-scanners.md` para um guia sobre como adicionar suporte a novas linguagens.
---
## 📜 Licença
AGPL-3.0-or-later - Consulte o arquivo [LICENSE](https://github.com/pantheon-security/medusa/blob/main/LICENSE)
MEDUSA é um software livre e de código aberto. Você pode usar, modificar e distribuí-lo livremente, mas quaisquer modificações ou trabalhos derivados (incluindo implantações SaaS) também devem ser lançados sob AGPL-3.0.
Para opções de licenciamento comercial, entre em contato: [email protected]
---
## Em Breve
O MEDUSA Professional adiciona **proteção em tempo de execução** para aplicações LLM em produção - bloqueando tentativas de injeção de prompt, jailbreak e exfiltração de dados em tempo real antes que elas cheguem aos seus modelos.
| Recurso | Código Aberto | Profissional | Enterprise |
|---------|-------------|--------------|------------|
| Varredura estática (40.000+ padrões) | Sim | Sim | Sim |
| Filtros de proxy em tempo de execução (1.100+) | - | Sim | Sim |
| API REST e webhooks | - | Sim | Sim |
| Regras personalizadas e SSO | - | - | Sim |
| **Preço** | Gratuito | $99/dev/mês | $499/50 devs/mês |
O proxy de tempo de execução está atualmente em beta privado. Se você está protegendo aplicações LLM em produção e quer acesso antecipado, entre em contato com **[email protected]**.
---
## 🙏 Créditos
**Desenvolvimento:**
- Pantheon Security
- Claude AI (Anthropic) - desenvolvimento assistido por IA
**Construído com:**
- Python 3.10+
- Click - framework de CLI
- Rich - Formatação de terminal
- Bandit, ESLint, ShellCheck e mais de 39 outras ferramentas de segurança de código aberto
**Inspirado por:**
- Bandit (segurança em Python)
- SonarQube (análise de múltiplas linguagens)
- Semgrep (segurança baseada em padrões)
- Mega-Linter (linting abrangente)
---
## 📖 Guias
- **[Início Rápido](https://github.com/pantheon-security/medusa/blob/main/docs/guides/quick-start.md)** - Comece a usar em 5 minutos
- **[Varredura de Segurança de IA](https://github.com/pantheon-security/medusa/blob/main/docs/AI_SECURITY.md)** - Guia completo para segurança de IA/LLM (OWASP 2025, MCP, RAG)
- **[Lidando com Falsos Positivos](https://github.com/pantheon-security/medusa/blob/main/docs/guides/handling-false-positives.md)** - Reduza o ruído, encontre problemas reais
- **[Integração com IDE](https://github.com/pantheon-security/medusa/blob/main/docs/guides/ide-integration.md)** - Configure Claude Code, Gemini, Copilot
---
## 📞 Suporte
- **GitHub Issues**: [Relate bugs ou solicite recursos](https://github.com/Pantheon-Security/medusa/issues)
- **Email**: [email protected]
- **Documentação**: https://docs.pantheonsecurity.io
- **Discord**: https://discord.gg/medusa (em breve)
---
## 📈 Estatísticas
**Versão**: 2026.5.5
**Data de Lançamento**: 2026-04-03
**Padrões de Detecção**: 40.000+ regras de segurança de IA
**Analisadores**: 79 scanners especializados
**Padrões de Filtro FP**: 514 filtros inteligentes (taxa de redução de 96,8%)
**Cobertura de CVEs**: 200 vulnerabilidades críticas (37+ CVEs de editores de IA)
**Envenenamento de Repositório**: 28+ tipos de arquivos de configuração de editores de IA detectados
**Cobertura de Linguagens**: 46+ tipos de arquivo
**Suporte de Plataforma**: Linux, macOS, Windows
**Integração de IA**: Claude Code, Gemini CLI, GitHub Copilot, Cursor, OpenAI Codex
**Padrões**: OWASP Top 10 para LLM 2025, MITRE ATLAS
**Downloads**: 11.500+ no PyPI
---
## 🌟 Por que o MEDUSA?
### vs. Bandit
- ✅ 40.000+ padrões (não apenas segurança em Python)
- ✅ Cobertura de segurança em IA/ML
- ✅ Zero configuração necessária
- ✅ Integração com IDE
### vs. SonarQube
- ✅ Configuração mais simples (`pip install && scan`)
- ✅ Nenhum servidor necessário
- ✅ Foco em segurança com prioridade para IA
- ✅ Gratuito e de código aberto
### vs. Semgrep
- ✅ Regras específicas de IA/ML embutidas
- ✅ Segurança para MCP, RAG e agentes
- ✅ Melhor integração com IDE
- ✅ Nenhuma configuração de regras necessária
### vs. SAST Tradicional
- ✅ Funciona imediatamente (sem instalação de ferramentas)
- ✅ Padrões de segurança de IA incluídos
- ✅ Processamento paralelo
- ✅ Cache inteligente
---
**🐍🐍🐍 MEDUSA - Scanner de Segurança Multilíngue 🐍🐍🐍**
**Um Comando. Segurança Completa.**```bash
medusa init && medusa scan .
Última atualização: 2026-04-03 Status: Pronto para produção Versão atual: v2026.5.5 - Endurecimento de segurança