Repolode
KryptosAI

KryptosAI/mcp-observatory

CLI de código abierto para pruebas de seguridad y regresión de servidores MCP, integrado con CI y con detección de cambios en esquemas, simulación segura de ataques y salida SARIF.

Estrellas
120
Forks
15
Issues abiertos
20
Último commit
hace 3 días

¿Qué es?

MCP Observatory es una herramienta de línea de comandos para probar servidores del Model Context Protocol (MCP) antes de que los agentes de IA dependan de ellos. Se conecta a un servidor, comprueba sus herramientas, prompts y recursos, puede invocar herramientas seguras de solo lectura para confirmar que funcionan y asigna una puntuación de estado de 0 a 100 con una calificación.

La herramienta se centra en comprobaciones de regresión y seguridad que se integran en CI. Puede registrar una sesión del servidor en un archivo cassette, reproducirla sin conexión, verificar un servidor activo comparándolo con esa grabación y comparar dos ejecuciones para mostrar campos añadidos o eliminados y cambios incompatibles en los parámetros. También analiza los esquemas de las herramientas en busca de patrones de riesgo, como superficies de inyección de comandos, acceso amplio al sistema de archivos y filtraciones de credenciales.

Los resultados se pueden guardar en formato SARIF para GitHub Code Scanning, y el comando setup-ci genera workflows de GitHub Actions o GitLab CI. El proyecto también puede ejecutarse como servidor MCP, para que un agente use sus comprobaciones en otros servidores. Requiere Node.js 20 o posterior y está disponible mediante npx, Homebrew y Docker.

Funciones clave

  • 01Comprueba las herramientas, los prompts y los recursos de servidores MCP e informa una puntuación de estado de 0 a 100.
  • 02Detecta cambios en los esquemas comparando dos ejecuciones para encontrar cambios añadidos, eliminados o incompatibles.
  • 03Registra sesiones en archivos cassette y las reproduce o verifica sin conexión.
  • 04Simula ataques seguros y señala patrones de riesgo en los esquemas de las herramientas.
  • 05Exporta los hallazgos en formato SARIF y genera workflows de GitHub Actions o GitLab CI.
  • 06Puede ejecutarse como servidor MCP para que los agentes prueben otros servidores MCP.

Casos de uso

  • Añadir una comprobación de seguridad y compatibilidad al pipeline de CI de un servidor MCP personalizado.
  • Detectar cambios inesperados en los esquemas de las herramientas antes de que afecten a los agentes que dependen de un servidor.
  • Revisar servidores MCP de terceros para detectar patrones de riesgo en sus herramientas antes de instalarlos.
  • Subir hallazgos de MCP a GitHub Code Scanning en las pull requests.

Inicio rápido

  1. 1

    Ejecuta el primer análisis con npx

    npx -y @kryptosai/mcp-observatory@latest
  2. 2

    Prueba un servidor MCP específico

    npx -y @kryptosai/mcp-observatory@latest test npx -y @modelcontextprotocol/server-everything
  3. 3

    Abre el panel local para revisar los resultados

    npx -y @kryptosai/mcp-observatory@latest dashboard

Antes de usarlo

  • Requiere Node.js 20 o una versión posterior.
  • Algunas funciones avanzadas, como el flujo de trabajo ClearFrame, dependen de una aplicación para Mac que solo es compatible con Apple Silicon.

En colecciones

Temas

Preguntas frecuentes

¿Qué es mcp-observatory?
CLI de código abierto para pruebas de seguridad y regresión de servidores MCP, integrado con CI y con detección de cambios en esquemas, simulación segura de ataques y salida SARIF. MCP Observatory es una herramienta de línea de comandos para probar servidores del Model Context Protocol (MCP) antes de que los agentes de IA dependan de ellos. Se conecta a un servidor, comprueba sus herramientas, prompts y recursos, puede invocar herramientas seguras de solo lectura para confirmar que funcionan y asigna una puntuación de estado de 0 a 100 con una calificación.
¿mcp-observatory es gratuito? ¿Qué licencia tiene?
mcp-observatory es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp-observatory sigue mantenido?
Mantenimiento activo. El último commit de mcp-observatory fue el 4 nov 2026.
¿Para qué puedo usar mcp-observatory?
Añadir una comprobación de seguridad y compatibilidad al pipeline de CI de un servidor MCP personalizado. Detectar cambios inesperados en los esquemas de las herramientas antes de que afecten a los agentes que dependen de un servidor. Revisar servidores MCP de terceros para detectar patrones de riesgo en sus herramientas antes de instalarlos. Subir hallazgos de MCP a GitHub Code Scanning en las pull requests.
¿Cómo se instala mcp-observatory?
Ejecuta el primer análisis con npx: npx -y @kryptosai/mcp-observatory@latest Prueba un servidor MCP específico: npx -y @kryptosai/mcp-observatory@latest test npx -y @modelcontextprotocol/server-everything Abre el panel local para revisar los resultados: npx -y @kryptosai/mcp-observatory@latest dashboard
¿Dónde consigo mcp-observatory?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/KryptosAI/mcp-observatory

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

Proyectos relacionados