Repolode
cisco-ai-defense

cisco-ai-defense/mcp-scanner

Herramienta de Python de Cisco que analiza servidores MCP, herramientas, prompts y código fuente en busca de amenazas de seguridad con reglas YARA, análisis con LLM y Cisco AI Defense.

Estrellas
1,094
Forks
148
Issues abiertos
74
Último commit
hace 4 días

¿Qué es?

MCP Scanner comprueba los servidores del Model Context Protocol y sus herramientas para detectar posibles comportamientos maliciosos y problemas de seguridad. Puede analizar herramientas, prompts, recursos e instrucciones de servidores remotos (SSE o HTTP transmitible), servidores locales stdio o archivos JSON generados previamente para usarlos sin conexión en pipelines de CI/CD.

El scanner combina tres motores: reglas YARA, análisis basado en LLM y la API de inspección de Cisco AI Defense. Se pueden ejecutar juntos o por separado. Incluye módulos adicionales para analizar el comportamiento del código fuente de servidores MCP, consultar hashes de binarios incluidos en VirusTotal, comprobar vulnerabilidades en dependencias de Python con pip-audit y analizar paquetes de PyPI y npm en un entorno aislado.

Está disponible como CLI (mcp-scanner), servidor de API REST (mcp-scanner-api) y SDK de Python. Los resultados se pueden presentar en formato de resumen, detallado, tabla, agrupado por nivel de gravedad o como JSON sin procesar.

Funciones clave

  • 01Analiza herramientas, prompts, recursos e instrucciones de servidores MCP para detectar problemas de seguridad.
  • 02Combina reglas YARA, análisis basado en LLM y la API de inspección de Cisco AI Defense, que se pueden usar juntos o por separado.
  • 03Se conecta a servidores MCP remotos (SSE, HTTP transmitible) y stdio, o lee archivos JSON estáticos sin conexión.
  • 04Incluye análisis de comportamiento del código fuente en diez lenguajes de programación.
  • 05Comprueba si hay vulnerabilidades conocidas CVE, PYSEC y GHSA en dependencias de Python con pip-audit.
  • 06Ofrece interfaces CLI, API REST y SDK de Python.

Casos de uso

  • Evaluar servidores MCP de terceros antes de conectarlos a un agente de IA.
  • Añadir comprobaciones sin conexión de definiciones de herramientas MCP a un pipeline de CI/CD sin necesidad de claves de API.
  • Analizar paquetes de PyPI o npm que proporcionan servidores MCP antes de instalarlos.
  • Auditar archivos de configuración de clientes MCP que ya estén en el equipo de un desarrollador.

Inicio rápido

  1. 1

    Instala la herramienta CLI con uv

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

    Ejecuta un análisis YARA de un 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 usarlo

  • Varios analizadores requieren claves de API, como la API de Cisco AI Defense, un proveedor de LLM o VirusTotal.
  • Sin VIRUSTOTAL_API_KEY, no se analizan los archivos binarios en busca de malware.
  • Requiere Python 3.11 o superior y uv.

Temas

Preguntas frecuentes

¿Qué es mcp-scanner?
Herramienta de Python de Cisco que analiza servidores MCP, herramientas, prompts y código fuente en busca de amenazas de seguridad con reglas YARA, análisis con LLM y Cisco AI Defense. MCP Scanner comprueba los servidores del Model Context Protocol y sus herramientas para detectar posibles comportamientos maliciosos y problemas de seguridad. Puede analizar herramientas, prompts, recursos e instrucciones de servidores remotos (SSE o HTTP transmitible), servidores locales stdio o archivos JSON generados previamente para usarlos sin conexión en pipelines de CI/CD.
¿mcp-scanner es gratuito? ¿Qué licencia tiene?
mcp-scanner es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp-scanner sigue mantenido?
Mantenimiento activo. El último commit de mcp-scanner fue el 16 oct 2026.
¿Para qué puedo usar mcp-scanner?
Evaluar servidores MCP de terceros antes de conectarlos a un agente de IA. Añadir comprobaciones sin conexión de definiciones de herramientas MCP a un pipeline de CI/CD sin necesidad de claves de API. Analizar paquetes de PyPI o npm que proporcionan servidores MCP antes de instalarlos. Auditar archivos de configuración de clientes MCP que ya estén en el equipo de un desarrollador.
¿Cómo se instala mcp-scanner?
Instala la herramienta CLI con uv: uv tool install --python 3.13 cisco-ai-mcp-scanner Ejecuta un análisis YARA de un 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
¿Dónde consigo mcp-scanner?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/cisco-ai-defense/mcp-scanner

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados