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
<a name="agent-tools-valkey-mcp-getting-started"></a>

## Installation
<a name="agent-tools-valkey-mcp-installation"></a>

**Voraussetzungen:** Python 3.10 oder höher`uv`, 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_SSL": "true"
      }
    }
  }
}
```

Ersetzen Sie es `<your-endpoint>` durch den Endpunkt Ihres Valkey-Datenspeichers. Ihr Codierungsagent 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 zur Einrichtung des SSM-Tunnels, zur Generierung von IAM-Authentifizierungstoken und zur TLS-Behandlung im Tunnelmodus finden Sie im [ElastiCache Verbindungsleitfaden](https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-elasticache/references/setup/connection-guide.md) im AWS Agent-Toolkit oder installieren Sie den [Amazon ElastiCache Skill](agent-tools-skills.md), 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 auffordern, die Verbindung zu überprüfen mit:

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

## Konfiguration
<a name="agent-tools-valkey-mcp-configuration"></a>

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


<table>
<thead>
  <tr><th>Variable</th><th>Zweck</th></tr>
</thead>
<tbody>
  <tr><td>VALKEY\_HOST</td><td>Gibt den Endpunkt Ihres Valkey-Datenspeichers an. 127.0.0.1Wird verwendet, wenn Sie über einen Tunnel eine Verbindung zu einem privaten ElastiCache Cluster herstellen.</td></tr>
  <tr><td>VALKEY\_USE\_SSL</td><td>Auf einstellen, true um TLS zu aktivieren. Dies ist für ElastiCache Cluster erforderlich, bei denen die Verschlüsselung bei der Übertragung aktiviert ist.</td></tr>
  <tr><td>--readonly</td><td>Schränkt den Server auf die Leseebene ein und deaktiviert alle Schreib- und Verwaltungstools, sodass er für die Produktionserkundung geeignet ist.</td></tr>
  <tr><td colspan="2">Optionale Suchparameter</td></tr>
  <tr><td>EMBEDDINGS\_PROVIDER</td><td>Wählt den von add\_documents und search verwendeten Einbettungsanbieter aus. Unterstützte Optionen sindbedrock, openaiollama, undhash. Wird hash für lokale Tests ohne Anmeldeinformationen verwendet.</td></tr>
  <tr><td>BEDROCK\_MODEL\_ID</td><td>Setzt das standardmäßige Einbettungsmodell von Amazon Bedrock außer Kraft.</td></tr>
  <tr><td>OPENAI\_API\_KEY</td><td>Stellt den API-Schlüssel bereit, der erforderlich ist, wenn er auf gesetzt EMBEDDING\_PROVIDER ist. openai</td></tr>
</tbody>
</table>