View a markdown version of this page

Prise en main - Amazon ElastiCache
InstallationConfiguration

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Prise en main

Installation

Prérequis : Python 3.10 ou version ultérieureuv, accès à une banque de données Valkey

Configurez votre client MCP : Ajoutez ce qui suit à la configuration de votre client MCP :

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

<your-endpoint>Remplacez-le par le point de terminaison de votre banque de données Valkey. Votre agent de codage doit disposer d'un accès réseau au point de terminaison.

Connexion à Amazon ElastiCache : les clusters ElastiCache Valkey se trouvent dans un VPC privé et ne sont pas accessibles directement depuis votre machine locale. Pour la configuration du tunnel SSM, la génération de jetons d'authentification IAM et la gestion du protocole TLS en mode tunnel, consultez le guide de ElastiCache connexion dans l' AWS Agent Toolkit, ou installez Amazon ElastiCache Skill pour laisser votre agent gérer la configuration de la connexion de bout en bout. Une fois le tunnel établi, utilisez-le VALKEY_HOST=127.0.0.1 dans la configuration ci-dessus.

Redémarrez votre client MCP après avoir enregistré la configuration.

Vous pouvez demander à votre agent de vérifier la connexion avec :

Utilisez le serveur Valkey MCP pour vérifier la connexion à ma banque de données et confirmer que les opérations Valkey sont disponibles.

Configuration

Configurez le serveur Valkey MCP via des variables d'environnement dans la configuration de votre client MCP. Vous pouvez également utiliser l'--readonlyindicateur pour restreindre l'accès des agents aux opérations en lecture seule.

Variable Objectif
VALKEY_HOST Spécifie le point de terminaison de votre banque de données Valkey. À utiliser 127.0.0.1 lors de la connexion à un ElastiCache cluster privé via un tunnel.
VALKEY_USE_SSL Définissez sur pour true activer le protocole TLS. Cela est nécessaire pour les ElastiCache clusters sur lesquels le chiffrement en transit est activé.
--readonly Limite le serveur au niveau de lecture et désactive tous les outils d'écriture et d'administration, ce qui le rend adapté à l'exploration de production.
Paramètres de recherche facultatifs
EMBEDDINGS_PROVIDER Sélectionne le fournisseur d'intégration utilisé par add_documents et. search Les options prises en charge sont bedrock openaiollama,, ethash. À utiliser hash pour des tests locaux sans informations d'identification.
BEDROCK_MODEL_ID Remplace le modèle d'intégration par défaut d'Amazon Bedrock.
OPENAI_API_KEY Fournit la clé d'API requise lorsque EMBEDDING_PROVIDER ce paramètre est défini suropenai.