View a markdown version of this page

Erste Schritte - Amazon ElastiCache

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erste Schritte

Installation

Voraussetzungen: Python 3.10 oder höheruv, Zugriff auf einen Valkey-Datenspeicher

Konfigurieren Sie Ihren MCP-Client: Fügen Sie Ihrer MCP-Client-Konfiguration Folgendes hinzu:

{ "mcpServers": { "valkey": { "command": "uvx", "args": ["awslabs.valkey-mcp-server@latest"], "env": { "VALKEY_HOST": "<your-endpoint>", "VALKEY_USE_SSL": "true" } } } }

Ersetzen Sie es <your-endpoint> durch den Endpunkt Ihres Valkey-Datenspeichers. Ihr Coding-Agent muss Netzwerkzugriff auf den Endpunkt haben.

Verbindung zu Amazon herstellen ElastiCache: ElastiCache Valkey-Cluster befinden sich in einer privaten VPC und sind nicht direkt von Ihrem lokalen Computer aus erreichbar. Informationen zum SSM-Tunnel-Setup, zur Generierung von IAM-Authentifizierungstoken und zur TLS-Handhabung im Tunnelmodus finden Sie in der ElastiCache Verbindungsanleitung im AWS Agent Toolkit, oder installieren Sie den Amazon ElastiCache Skill, damit Ihr Agent die Verbindungseinrichtung von Anfang bis Ende übernimmt. Nachdem der Tunnel eingerichtet ist, verwenden Sie ihn VALKEY_HOST=127.0.0.1 in der obigen Konfiguration.

Starten Sie Ihren MCP-Client neu, nachdem Sie die Konfiguration gespeichert haben.

Sie können Ihren Agenten bitten, die Verbindung zu überprüfen mit:

Verwenden Sie den Valkey MCP-Server, um die Verbindung zu meinem Datenspeicher zu überprüfen und zu bestätigen, dass Valkey-Operationen verfügbar sind.

Konfiguration

Konfigurieren Sie den Valkey MCP-Server über Umgebungsvariablen in Ihrer MCP-Client-Konfiguration. Sie können das --readonly Flag auch verwenden, um den Agentenzugriff auf schreibgeschützte Operationen zu beschränken.

Variable Zweck
VALKEY_HOST Gibt den Endpunkt Ihres Valkey-Datenspeichers an. 127.0.0.1Wird verwendet, wenn über einen Tunnel eine Verbindung zu einem privaten ElastiCache Cluster hergestellt wird.
VALKEY_USE_SSL Auf setzen, true um TLS zu aktivieren. Dies ist für ElastiCache Cluster erforderlich, bei denen die Verschlüsselung bei der Übertragung aktiviert ist.
--readonly Schränkt den Server auf die Leseebene ein und deaktiviert alle Schreib- und Verwaltungstools, sodass er für die Produktionsumgebung geeignet ist.
Optionale Suchparameter
EMBEDDINGS_PROVIDER Wählt den von add_documents und search verwendeten Einbettungsprovider aus. Die unterstützten Optionen sindbedrock, openaiollama, undhash. Wird hash für lokale Tests ohne Anmeldeinformationen verwendet.
BEDROCK_MODEL_ID Überschreibt das standardmäßige Amazon Bedrock-Einbettungsmodell.
OPENAI_API_KEY Stellt den API-Schlüssel bereit, der erforderlich EMBEDDING_PROVIDER ist, wenn auf gesetzt ist. openai