Servidor de protocolo de contexto de modelo (MCP) de Steampipe

¡Desbloquea el poder del análisis de infraestructura basado en IA con Steampipe ! Este servidor de Protocolo de Contexto de Modelo conecta a la perfección asistentes de IA como Claude con los datos de tu infraestructura en la nube, lo que permite la exploración y el análisis en lenguaje natural de toda tu infraestructura en la nube.

Steampipe MCP conecta los asistentes de IA con los datos de su infraestructura, lo que permite el lenguaje natural:

• Consultas en AWS, Azure, GCP y más de 100 servicios en la nube

• Análisis de seguridad y cumplimiento

• Optimización de costos y recursos

• Asistencia para el desarrollo de consultas

Funciona tanto con instalaciones locales de Steampipe como con espacios de trabajo de Turbot Pipes , proporcionando acceso seguro y de solo lectura a todos sus datos en la nube y SaaS.

Instalación

Prerrequisitos

• Node.js v16 o superior (incluye npx )

• Para uso local: Steampipe instalado y en funcionamiento ( steampipe service start )

• Para Turbot Pipes: un espacio de trabajo de Turbot Pipes y una cadena de conexión

Configuración

Añade Steampipe MCP al archivo de configuración de tu asistente de IA:

De forma predeterminada, se conecta a tu instalación local de Steampipe en postgresql://steampipe@localhost:9193/steampipe . Asegúrate de ejecutar primero steampipe service start .

Para conectarse a un espacio de trabajo de Turbot Pipes , agregue su cadena de conexión a los argumentos:

Configuración del asistente de IA

Guarde el archivo de configuración y reinicie su asistente de IA para que los cambios surtan efecto.

Guía de indicaciones

Primero, ejecuta el mensaje best_practices incluido en el servidor MCP para enseñarle a tu LLM cómo trabajar mejor con Steampipe. ¡Luego, pregúntale lo que quieras!

Explora tu infraestructura en la nube:

Las preguntas simples y específicas funcionan bien:

Generar informes de infraestructura:

Profundice en el análisis de seguridad:

Obtenga información sobre cumplimiento:

Explorar los riesgos potenciales:

Recuerde:

• Sea específico sobre qué recursos de la nube desea analizar (EC2, S3, IAM, etc.)

• Mencione regiones o cuentas si está interesado en algunas específicas.

• Comience con consultas simples antes de agregar condiciones complejas

• Utilice lenguaje natural: el LLM se encargará de la traducción SQL

• Sea audaz y explorador: ¡el LLM puede ayudarle a descubrir conocimientos en toda su infraestructura!

Capacidades

Herramientas

• consulta de tubería de vapor

  • Consultar registros de seguridad y de la nube con SQL.

  • Para obtener un mejor rendimiento: utilice CTE en lugar de uniones y limite las columnas solicitadas.

  • Todas las consultas son de solo lectura y utilizan la sintaxis PostgreSQL.

  • Entrada: sql (cadena): La consulta SQL que se ejecutará utilizando la sintaxis PostgreSQL

• lista_de_tablas_de_steampipe

  • Enumere todas las tablas Steampipe disponibles.

  • Entrada opcional: schema (cadena): Filtrar tablas por esquema específico

  • Entrada opcional: filter (cadena): Filtrar tablas por patrón ILIKE (por ejemplo, '%ec2%')

• presentación de tabla de steampipe

  • Obtenga información detallada sobre una tabla específica, incluidas definiciones de columnas, tipos de datos y descripciones.

  • Entrada: name (cadena): el nombre de la tabla para la que se mostrarán detalles (puede estar calificado por el esquema, por ejemplo, 'aws_account' o 'aws.aws_account')

  • Entrada opcional: schema (cadena): El esquema que contiene la tabla

• lista de complementos de steampipe

  • Enumera todos los complementos de Steampipe instalados en el sistema. Los complementos proporcionan acceso a diferentes fuentes de datos como AWS, GCP o Azure.

  • No se requieren parámetros de entrada

• presentación del complemento steampipe

  • Obtenga detalles para una instalación específica de un complemento de Steampipe, incluida la versión, los límites de memoria y la configuración.

  • Entrada: name (cadena): Nombre del complemento para el que se mostrarán detalles

Indicaciones

• mejores prácticas

  • Mejores prácticas para trabajar con datos de Steampipe

  • Proporciona orientación detallada sobre:

    • Estilo de respuesta y convenciones de formato

    • Uso de CTE (cláusulas WITH) frente a uniones

    • Convenciones de sintaxis y estilo de SQL

    • Selección y optimización de columnas

    • Exploración y comprensión de esquemas

    • Estructura y organización de la consulta

    • Consideraciones de rendimiento y almacenamiento en caché

    • Manejo de errores y resolución de problemas

Recursos

• estado

  • Representa el estado actual de la conexión Steampipe

  • Las propiedades incluyen:

    • connection_string: La cadena de conexión a la base de datos actual

    • estado: El estado de la conexión (conectado/desconectado)

Este recurso permite que las herramientas de IA verifiquen el estado de la conexión a su instancia de Steampipe.

Desarrollo

Clonar y configurar

1. Clona el repositorio y navega hasta el directorio:

2. Instalar dependencias:

3. Construir el proyecto:

Pruebas

Para probar su compilación de desarrollo local con herramientas de IA compatibles con MCP, actualice la configuración de MCP para usar el dist/index.js local en lugar del paquete npm. Por ejemplo:

O utilice el Inspector MCP para validar la implementación del servidor:

Variables de entorno

Las siguientes variables de entorno se pueden utilizar para configurar el servidor MCP:

• STEAMPIPE_MCP_LOG_LEVEL : Controla el nivel de detalle del registro del servidor (predeterminado: info )

• STEAMPIPE_MCP_WORKSPACE_DATABASE : Anula la cadena de conexión predeterminada de Steampipe (predeterminada: postgresql://steampipe@localhost:9193/steampipe )

Código abierto y contribución

Este repositorio se publica bajo la licencia Apache 2.0 . Consulte nuestro código de conducta . ¡Esperamos colaborar con usted!

Steampipe es un producto desarrollado a partir de este software de código abierto, exclusivamente por Turbot HQ, Inc. Se distribuye bajo nuestros términos comerciales. Otros pueden crear su propia distribución del software, pero no pueden usar las marcas registradas, servicios en la nube, etc. de Turbot. Puede obtener más información en nuestras Preguntas frecuentes sobre código abierto .

Complicarse

Únete a #steampipe en Slack →

¿Quieres ayudar pero no sabes por dónde empezar? Elige uno de los temas help wanted :

• Tubería de vapor

• Tubo de vapor MCP