@gnaws/mcp

Lass deine KI sehen, was unter deiner Cloud liegt.

MCP (Model Context Protocol) Server für @gnaws/core — macht AWS-Ressourcenscans, Graphenerstellung und Erkennung ungenutzter Ressourcen als Werkzeuge für KI-Agenten verfügbar.

Was ist das?

Ein MCP-Server, der KI-Agenten (Claude, Kiro, Cursor, etc.) die Möglichkeit gibt:

• Dein AWS-Konto zu scannen und einen Ressourcenbeziehungsgraphen zu erstellen

• Bereits exportierte Daten zu laden für die Offline-Analyse

• Ungenutzte/verwaiste Ressourcen zu erkennen (abgetrennte Volumes, nicht zugeordnete IPs, leere Load Balancer, etc.)

• Den Graphen zu exportieren nach GEXF (Gephi), JSON (sigma.js) oder Markdown

• Rohdaten zu sichern für die spätere Verwendung

Related MCP server: AWS SRA Verify MCP Server

Installation

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

Erfordert Node.js >= 24.

MCP-Client-Konfiguration

Kiro

Füge zu .kiro/settings/mcp.json hinzu:

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

Claude Desktop

Füge zu claude_desktop_config.json hinzu:

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

VS Code (GitHub Copilot)

Füge zu .vscode/mcp.json hinzu:

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

Cursor

Füge zu .cursor/mcp.json (Projekt) oder ~/.cursor/mcp.json (global) hinzu:

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

Verfügbare Werkzeuge

Beispielgespräche

Benutzer: Zeig mir die ungenutzten Ressourcen in meinem AWS-Konto Agent: ruft scan mit Profil auf → ruft detect auf → präsentiert Ergebnisse

Benutzer: Lade den Dump aus ./data und exportiere einen Graphen Agent: ruft load mit Pfad auf → ruft export mit Format "gexf" auf

Benutzer: Wie ist der Zustand des gnaws-Servers? Agent: ruft status auf → meldet keine Daten geladen, schlägt scan oder load vor

Funktionen

• Fortschrittsmeldungen — langlebige Scans melden Fortschritt an den Agenten

• Fehlerbehandlung — jedes Werkzeug gibt strukturierte Fehler mit umsetzbaren Hinweisen zurück

• Workflow-Führung — Werkzeugantworten sagen dem Agenten, was als nächstes aufgerufen werden soll

• Offline-Modus — aus Dumps laden ohne AWS-Anmeldedaten

• 65+ AWS-Dienste — EC2, Lambda, S3, RDS, ECS, EKS, DynamoDB und viele mehr

Protokollebene

Die gesamte Protokollierung erfolgt über stderr (sicher für MCP stdio-Transport). Steuere die Ausführlichkeit mit:

LOG_LEVEL=debug npx @gnaws/mcp

Verfügbare Ebenen: debug, info, warn, error, silent (Standard: info).

Entwicklung

# 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

Mitwirken

Siehe CONTRIBUTING.md.

Unterstützung

Wenn GNAWS dir Geld bei deiner AWS-Rechnung spart, erwäge, das Projekt zu sponsern.

Lizenz

AGPL-3.0 — siehe LICENSE.

Nicht verbunden mit oder unterstützt von Amazon Web Services.