Repolode
cisco-ai-defense

cisco-ai-defense/mcp-scanner

Ferramenta Python da Cisco que verifica servidores MCP, ferramentas, prompts e código-fonte em busca de ameaças, usando regras YARA, análise de LLM e Cisco AI Defense.

Estrelas
1,094
Forks
148
Issues abertas
74
Último commit
há 4 dias

O que é?

O MCP Scanner verifica servidores Model Context Protocol e suas ferramentas em busca de possíveis comportamentos maliciosos e problemas de segurança. Ele pode analisar ferramentas, prompts, recursos e instruções de servidores remotos (SSE ou streamable HTTP), servidores locais via stdio ou arquivos JSON pré-gerados para uso offline em pipelines de CI/CD.

O scanner combina três mecanismos: regras YARA, análise baseada em LLM e a API inspect do Cisco AI Defense. Eles podem ser executados em conjunto ou de forma independente. Módulos adicionais analisam o comportamento do código-fonte de servidores MCP, consultam hashes de binários incluídos no VirusTotal, verificam vulnerabilidades em dependências Python usando pip-audit e analisam pacotes PyPI e npm em sandbox.

A ferramenta está disponível como CLI (mcp-scanner), servidor REST API (mcp-scanner-api) e Python SDK. A saída pode ser formatada como resumo, detalhada, em tabela, agrupada por nível de severidade ou como JSON bruto.

Recursos principais

  • 01Analisa ferramentas, prompts, recursos e instruções de servidores MCP em busca de problemas de segurança.
  • 02Combina regras YARA, análise baseada em LLM e a API inspect do Cisco AI Defense, que podem ser usadas em conjunto ou separadamente.
  • 03Conecta-se a servidores MCP remotos (SSE, streamable HTTP) e via stdio, ou lê arquivos JSON estáticos offline.
  • 04Inclui análise comportamental de código-fonte em dez linguagens de programação.
  • 05Verifica dependências Python em busca de vulnerabilidades conhecidas CVE, PYSEC e GHSA usando pip-audit.
  • 06Oferece interfaces de CLI, REST API e Python SDK.

Casos de uso

  • Avaliar servidores MCP de terceiros antes de conectá-los a um agente de IA.
  • Adicionar verificações offline de definições de ferramentas MCP a um pipeline de CI/CD, sem precisar de chaves de API.
  • Analisar pacotes PyPI ou npm que fornecem servidores MCP antes de instalá-los.
  • Auditar arquivos de configuração de clientes MCP já presentes na máquina de um desenvolvedor.

Início rápido

  1. 1

    Instale a ferramenta CLI com uv

    uv tool install --python 3.13 cisco-ai-mcp-scanner
  2. 2

    Execute uma verificação YARA em um servidor MCP stdio

    mcp-scanner --stdio-command uvx --stdio-arg=--from --stdio-arg=mcp-server-fetch --stdio-arg=mcp-server-fetch --analyzers yara --format summary

Antes de usar

  • Vários analisadores precisam de chaves de API, como a API do Cisco AI Defense, um provedor de LLM ou o VirusTotal.
  • Sem VIRUSTOTAL_API_KEY, os arquivos binários não são verificados quanto a malware.
  • Requer Python 3.11 ou superior e uv.

Tópicos

Perguntas frequentes

O que é mcp-scanner?
Ferramenta Python da Cisco que verifica servidores MCP, ferramentas, prompts e código-fonte em busca de ameaças, usando regras YARA, análise de LLM e Cisco AI Defense. O MCP Scanner verifica servidores Model Context Protocol e suas ferramentas em busca de possíveis comportamentos maliciosos e problemas de segurança. Ele pode analisar ferramentas, prompts, recursos e instruções de servidores remotos (SSE ou streamable HTTP), servidores locais via stdio ou arquivos JSON pré-gerados para uso offline em pipelines de CI/CD.
mcp-scanner é gratuito? Qual é a licença?
mcp-scanner é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-scanner ainda é mantido?
Manutenção ativa. O último commit de mcp-scanner foi em 16 de out. de 2026.
Para que posso usar mcp-scanner?
Avaliar servidores MCP de terceiros antes de conectá-los a um agente de IA. Adicionar verificações offline de definições de ferramentas MCP a um pipeline de CI/CD, sem precisar de chaves de API. Analisar pacotes PyPI ou npm que fornecem servidores MCP antes de instalá-los. Auditar arquivos de configuração de clientes MCP já presentes na máquina de um desenvolvedor.
Como instalar mcp-scanner?
Instale a ferramenta CLI com uv: uv tool install --python 3.13 cisco-ai-mcp-scanner Execute uma verificação YARA em um servidor MCP stdio: mcp-scanner --stdio-command uvx --stdio-arg=--from --stdio-arg=mcp-server-fetch --stdio-arg=mcp-server-fetch --analyzers yara --format summary
Onde consigo mcp-scanner?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/cisco-ai-defense/mcp-scanner

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

Projetos relacionados