tubería de vapor-mcp

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:

{
  "mcpServers": {
    "steampipe": {
      "command": "npx",
      "args": [
        "-y",
        "@turbot/steampipe-mcp"
      ]
    }
  }
}

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:

{
  "mcpServers": {
    "steampipe": {
      "command": "npx",
      "args": [
        "-y",
        "@turbot/steampipe-mcp",
        "postgresql://my_name:my_pw@workspace-name.usea1.db.pipes.turbot.com:9193/abc123"
      ]
    }
  }
}

Configuración del asistente de IA

Asistente	Ubicación del archivo de configuración	Guía de configuración
Escritorio de Claude	`claude_desktop_config.json`	Guía del MCP de Claude Desktop →
Cursor	`~/.cursor/mcp.json`	Guía del cursor MCP →

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:

What AWS accounts can you see?

Las preguntas simples y específicas funcionan bien:

Show me all S3 buckets that were created in the last week

Generar informes de infraestructura:

List my EC2 instances with their attached EBS volumes

Profundice en el análisis de seguridad:

Find any IAM users with access keys that haven't been rotated in the last 90 days

Obtenga información sobre cumplimiento:

Show me all EC2 instances that don't comply with our tagging standards

Explorar los riesgos potenciales:

Analyze my S3 buckets for security risks including public access, logging, and encryption

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, 'ì2%')
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

Clona el repositorio y navega hasta el directorio:

git clone https://github.com/turbot/steampipe-mcp.git
cd steampipe-mcp

Instalar dependencias:

npm install

Construir el proyecto:

npm run build

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:

{
  "mcpServers": {
    "steampipe": {
      "command": "node",
      "args": [
        "/absolute/path/to/steampipe-mcp/dist/index.js",
        "postgresql://steampipe@localhost:9193/steampipe"
      ]
    }
  }
}

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

npx @modelcontextprotocol/inspector dist/index.js

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 :

steampipe-mcp