Aiven MCP Server

Aiven MCP Server

Ein Model Context Protocol (MCP)-Server für Aiven.

Dies ermöglicht den Zugriff auf die in Aiven ausgeführten Aiven-Dienste für PostgreSQL, Kafka, ClickHouse, Valkey und OpenSearch sowie auf das breitere Aiven-Ökosystem nativer Konnektoren. LLMs können so Full-Stack-Lösungen für alle Anwendungsfälle erstellen.

Merkmale

Werkzeuge

• list_projects
  • Listen Sie alle Projekte in Ihrem Aiven-Konto auf.
• list_services
  • Listen Sie alle Dienste in einem bestimmten Aiven-Projekt auf.
• get_service_details
  • Erhalten Sie Einzelheiten zu Ihrem Service in einem bestimmten Aiven-Projekt.

Konfiguration für Claude Desktop

1. Öffnen Sie die Claude Desktop-Konfigurationsdatei unter:
   • Unter macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Unter Windows: %APPDATA%/Claude/claude_desktop_config.json
2. Fügen Sie Folgendes hinzu:

Aktualisieren Sie die Umgebungsvariablen:

• $REPOSITORY_DIRECTORY um auf den Ordner zu verweisen, der das Repository enthält
• AIVEN_TOKEN zum Aiven-Anmeldetoken .

3. Suchen Sie den Befehlseintrag für uv und ersetzen Sie ihn durch den absoluten Pfad zur ausführbaren Datei uv . Dadurch wird sichergestellt, dass beim Serverstart die richtige Version von uv verwendet wird. Auf einem Mac finden Sie diesen Pfad mit which uv .
4. Starten Sie Claude Desktop neu, um die Änderungen zu übernehmen.

Konfiguration für Cursor

1. Navigieren Sie zu Cursor -> Einstellungen -> Cursoreinstellungen
2. Wählen Sie „MCP-Server“
3. Fügen Sie einen neuen Server hinzu mit
   • Name: mcp-aiven
   • Typ: command
   • Befehl: uv --directory $REPOSITORY_DIRECTORY run --with-editable $REPOSITORY_DIRECTORY --python 3.13 mcp-aiven

Wobei $REPOSITORY_DIRECTORY der Pfad zum Repository ist. Möglicherweise müssen Sie die Variablen AIVEN_BASE_URL , AIVEN_PROJECT_NAME und AIVEN_TOKEN hinzufügen.

Entwicklung

1. Fügen Sie die folgenden Variablen zu einer .env Datei im Stammverzeichnis des Repositorys hinzu.

2. Führen Sie uv sync aus, um die Abhängigkeiten zu installieren. Folgen Sie zur Installation uv den Anweisungen hier . Führen Sie anschließend source .venv/bin/activate .
3. Zum einfachen Testen können Sie mcp dev mcp_aiven/mcp_server.py ausführen, um den MCP-Server zu starten.

Umgebungsvariablen

Die folgenden Umgebungsvariablen werden zum Konfigurieren der Aiven-Verbindung verwendet:

Erforderliche Variablen

• AIVEN_BASE_URL : Die Aiven-API-URL
• AIVEN_TOKEN : Das Authentifizierungstoken

Überlegungen für Entwickler zu Model Context Protocols (MCPs) und KI-Agenten

In diesem Abschnitt werden die wichtigsten Verantwortlichkeiten und Sicherheitsaspekte des Entwicklers bei der Arbeit mit Model Context Protocols (MCPs) und KI-Agenten innerhalb dieses Systems beschrieben. Selbstverwaltete MCPs:

• Kundenverantwortung: MCPs werden in der Benutzerumgebung ausgeführt und nicht von Aiven gehostet. Daher sind die Benutzer gemäß dem Modell der geteilten Verantwortung allein für ihr operatives Management, ihre Sicherheit und ihre Compliance verantwortlich. ( https://aiven.io/responsibility-matrix )
• Bereitstellung und Wartung: Entwickler müssen alle Aspekte der MCP-Bereitstellung, -Aktualisierung und -Wartung übernehmen.

KI-Agent-Sicherheit:

• Berechtigungskontrolle: Zugriff und Funktionen von KI-Agenten werden streng durch die Berechtigungen geregelt, die dem für ihre Authentifizierung verwendeten API-Token erteilt wurden. Entwickler müssen diese Berechtigungen sorgfältig verwalten.
• Umgang mit Anmeldeinformationen: Beachten Sie, dass KI-Agenten möglicherweise Zugriffsberechtigungen (z. B. Datenbankverbindungszeichenfolgen, Streaming-Dienst-Token) benötigen, um Aktionen in Ihrem Namen auszuführen. Seien Sie äußerst vorsichtig, wenn Sie KI-Agenten solche Anmeldeinformationen bereitstellen.
• Risikobewertung: Halten Sie die Sicherheitsrichtlinien Ihres Unternehmens ein und führen Sie gründliche Risikobewertungen durch, bevor Sie KI-Agenten Zugriff auf vertrauliche Ressourcen gewähren.

Best Practices für API-Token:

• Prinzip der geringsten Privilegien: Halten Sie sich stets an das Prinzip der geringsten Privilegien. API-Token sollten auf die für ihre beabsichtigte Funktion erforderlichen Mindestberechtigungen beschränkt sein.
• Token-Verwaltung: Implementieren Sie robuste Token-Verwaltungsverfahren, einschließlich regelmäßiger Rotation und sicherer Speicherung.

Wichtige Erkenntnisse:

• Benutzer behalten die volle Kontrolle und Verantwortung für die MCP-Ausführung und -Sicherheit.
• Die Berechtigungen des KI-Agenten sind direkt an die Berechtigungen des API-Tokens gebunden.
• Seien Sie äußerst vorsichtig, wenn Sie KI-Agenten Anmeldeinformationen bereitstellen.
• Halten Sie sich bei der Verwaltung von API-Token strikt an das Prinzip der geringsten Privilegien.