@gnaws/mcp

Deja que tu agente de IA vea lo que hay debajo de tu nube.

Servidor MCP (Model Context Protocol) para @gnaws/core — expone el escaneo de recursos de AWS, la construcción de grafos y la detección de recursos no utilizados como herramientas para agentes de IA.

¿Qué es esto?

Un servidor MCP que brinda a los agentes de IA (Claude, Kiro, Cursor, etc.) la capacidad de:

• Escanear tu cuenta de AWS y construir un grafo de relaciones de recursos

• Cargar datos previamente volcados para análisis sin conexión

• Detectar recursos no utilizados/huérfanos (volúmenes desasociados, IPs no asociadas, balanceadores de carga vacíos, etc.)

• Exportar el grafo a GEXF (Gephi), JSON (sigma.js) o Markdown

• Volcar datos de recursos en bruto para uso posterior

Related MCP server: AWS SRA Verify MCP Server

Instalación

npm install -g @gnaws/mcp
# or run without installing:
npx @gnaws/mcp

Requiere Node.js >= 24.

Configuración del Cliente MCP

Kiro

Añadir a .kiro/settings/mcp.json:

{
  "mcpServers": {
    "gnaws": {
      "command": "npx",
      "args": ["@gnaws/mcp"]
    }
  }
}

Claude Desktop

Añadir a claude_desktop_config.json:

{
  "mcpServers": {
    "gnaws": {
      "command": "npx",
      "args": ["@gnaws/mcp"]
    }
  }
}

VS Code (GitHub Copilot)

Añadir a .vscode/mcp.json:

{
  "servers": {
    "gnaws": {
      "command": "npx",
      "args": ["@gnaws/mcp"]
    }
  }
}

Cursor

Añadir a .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "gnaws": {
      "command": "npx",
      "args": ["@gnaws/mcp"]
    }
  }
}

Herramientas Disponibles

Ejemplos de Conversaciones

Usuario: Muéstrame los recursos no utilizados en mi cuenta de AWS
Agente: llama a scan con perfil → llama a detect → presenta los hallazgos

Usuario: Carga el volcado desde ./data y exporta un grafo
Agente: llama a load con ruta → llama a export con formato "gexf"

Usuario: ¿Cuál es el estado del servidor gnaws?
Agente: llama a status → informa que no hay datos cargados, sugiere scan o load

Características

• Notificaciones de progreso — los escaneos largos informan el progreso al agente

• Manejo de errores — cada herramienta devuelve errores estructurados con orientación procesable

• Guía de flujo de trabajo — las respuestas de las herramientas le dicen al agente qué llamar a continuación

• Modo sin conexión — cargar desde volcados sin credenciales de AWS

• Más de 65 servicios de AWS — EC2, Lambda, S3, RDS, ECS, EKS, DynamoDB y muchos más

Nivel de Registro

Todo el registro va a stderr (seguro para el transporte MCP stdio). Controla la verbosidad con:

LOG_LEVEL=debug npx @gnaws/mcp

Niveles disponibles: debug, info, warn, error, silent (por defecto: info).

Desarrollo

# Build
npm run build

# Dev mode (tsx with hot reload)
npm run dev

# Type-check
npm run typecheck

# Lint
npm run lint

# Test with MCP Inspector
npx @modelcontextprotocol/inspector npx @gnaws/mcp

Contribuir

Ver CONTRIBUTING.md.

Soporte

Si GNAWS te ahorra dinero en tu factura de AWS, considera patrocinar el proyecto.

Licencia

AGPL-3.0 — ver LICENSE.

No afiliado ni respaldado por Amazon Web Services.