Repolode
highflame-ai

highflame-ai/ramparts

Scanner de segurança em Rust que audita servidores MCP e arquivos de skills de agentes de IA em busca de prompt injection, envenenamento de ferramentas, vazamento de segredos e riscos na cadeia de suprimentos.

Estrelas
98
Forks
20
Issues abertas
16
Último commit
há 14 dias

O que é?

O Ramparts verifica as duas superfícies em que um agente de IA mais confia: os servidores Model Context Protocol (MCP) aos quais se conecta e os arquivos de skills, como comandos de barra do Claude Code e pacotes agentskills.io, que carrega e executa pelo nome. Ele descobre as ferramentas, os recursos e os prompts de um servidor MCP por meio de transportes HTTP, SSE, stdio e subprocessos, e os audita em busca de prompt injection, envenenamento de ferramentas, path traversal, command injection e escalonamento entre origens.

A verificação de skills aplica o mesmo pipeline a diretórios com SKILL.md e aos scripts incluídos neles. O projeto combina regras YARA, um analisador semântico baseado em LLM, consultas de CVEs ao OSV.dev para servidores stdio npx/uvx e dependências fixadas, além de detecção de alterações baseada em fingerprints, que sinaliza mudanças em configurações MCP, ferramentas ou arquivos de skills após a aprovação. As descobertas são classificadas de acordo com o OWASP MCP Top 10 e o Agentic Skills Top 10 e podem ser exportadas como texto no terminal, JSON, SARIF 2.1.0 ou relatório Markdown.

A instalação é feita com cargo. O projeto também pode ser executado como servidor REST (`ramparts server`) ou como servidor MCP via stdio. Ele ainda está em desenvolvimento ativo, e seus autores observam que não é perfeito e deve ser combinado com proteções em tempo de execução.

Recursos principais

  • 01Verifica servidores MCP remotos e locais por meio de transportes HTTP, SSE, stdio e subprocessos.
  • 02Verifica comandos do Claude Code e pacotes agentskills.io, incluindo scripts e referências incluídos neles.
  • 03Executa 40 regras YARA com visualizações normalizadas e decodificadas para detectar palavras-chave ofuscadas.
  • 04Verifica dependências no OSV.dev em busca de CVEs conhecidas.
  • 05Detecta alterações em configurações MCP, ferramentas e arquivos de skills feitas após a aprovação.
  • 06Exporta os resultados como texto no terminal, JSON, SARIF 2.1.0 ou relatórios Markdown.

Casos de uso

  • Avaliar servidores MCP de terceiros antes de conectar um assistente de IA a eles.
  • Validar pacotes de skills agentskills.io antes de publicá-los.
  • Impedir a aprovação de pull requests que adicionem skills ou alterem configurações MCP no CI, usando a saída SARIF.
  • Auditar as skills instaladas pela equipe no Claude Code, Cursor e ferramentas semelhantes.

Início rápido

  1. 1

    Instale o Ramparts com Cargo

    cargo install ramparts
  2. 2

    Analise um servidor MCP de stdio

    ramparts scan "stdio:npx:mcp-server-commands"
  3. 3

    Descubra e analise automaticamente servidores MCP nas configurações do seu IDE

    ramparts scan-config

Antes de usar

  • O Ramparts está em desenvolvimento ativo e não é perfeito, por isso algumas descobertas podem ser imprecisas.
  • Ele analisa metadados estáticos, configurações e arquivos de skills, portanto não substitui as proteções em tempo de execução.
  • A análise baseada em LLM requer configuração adicional, que não é abordada no guia de início rápido.

Tópicos

Perguntas frequentes

O que é ramparts?
Scanner de segurança em Rust que audita servidores MCP e arquivos de skills de agentes de IA em busca de prompt injection, envenenamento de ferramentas, vazamento de segredos e riscos na cadeia de suprimentos. O Ramparts verifica as duas superfícies em que um agente de IA mais confia: os servidores Model Context Protocol (MCP) aos quais se conecta e os arquivos de skills, como comandos de barra do Claude Code e pacotes agentskills.io, que carrega e executa pelo nome. Ele descobre as ferramentas, os recursos e os prompts de um servidor MCP por meio de transportes HTTP, SSE, stdio e subprocessos, e os audita em busca de prompt injection, envenenamento de ferramentas, path traversal, command injection e escalonamento entre origens.
ramparts é gratuito? Qual é a licença?
ramparts é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
ramparts ainda é mantido?
Manutenção ativa. O último commit de ramparts foi em 8 de out. de 2026.
Para que posso usar ramparts?
Avaliar servidores MCP de terceiros antes de conectar um assistente de IA a eles. Validar pacotes de skills agentskills.io antes de publicá-los. Impedir a aprovação de pull requests que adicionem skills ou alterem configurações MCP no CI, usando a saída SARIF. Auditar as skills instaladas pela equipe no Claude Code, Cursor e ferramentas semelhantes.
Como instalar ramparts?
Instale o Ramparts com Cargo: cargo install ramparts Analise um servidor MCP de stdio: ramparts scan "stdio:npx:mcp-server-commands" Descubra e analise automaticamente servidores MCP nas configurações do seu IDE: ramparts scan-config
Onde consigo ramparts?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/highflame-ai/ramparts

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados