Uma biblioteca Python minimalista para criar agentes de IA que escrevem e executam suas ações como código Python.
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
Instale a ferramenta CLI com uv
uv tool install --python 3.13 cisco-ai-mcp-scanner - 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
Framework Python para criar agentes de IA autônomos que pesquisam, planejam, programam e executam tarefas, com memória, RAG e mais de 100 provedores de LLM.
SDK open source para criar e executar agentes de IA em Python e TypeScript, com ferramentas, MCP, memória e portabilidade entre modelos.
Framework Python para criar e orquestrar sistemas multiagente com fluxos de trabalho sequenciais, concorrentes, baseados em grafos e hierárquicos.
Sistema de memória para agentes que armazena, recupera e reflete sobre memórias para que agentes de IA aprendam com o tempo, em vez de apenas reproduzir o histórico de conversas.
Um espaço de trabalho com agentes para pesquisa e desenvolvimento de software, com vários modelos e estruturas de agentes open source, executado localmente ou hospedado.