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_USE_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 : si votre cache sans serveur Valkey possède un point de terminaison public, utilisez l'adresse du point de terminaison public sous la forme. VALKEY_HOST Aucun tunnel n'est requis. La connexion nécessite le protocole TLS 1.3 et un jeton d'authentification IAM. Pour plus de détails sur la génération du jeton, consultezConnectez-vous à un cache avec un point de terminaison public.

Pour tous les autres ElastiCache caches de Valkey, vous ne pouvez pas accéder au cache 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 lorsqu'EMBEDDING_PROVIDERil est défini suropenai.