本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 开始使用
<a name="agent-tools-valkey-mcp-getting-started"></a>

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

**先决条件：**Python 3.10 或更高版本`uv`，访问 Valkey 数据存储库

**配置您的 MCP 客户端：**将以下内容添加到 MCP 客户端配置中：

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

`<your-endpoint>`替换为您的 Valkey 数据存储库的终端节点。您的编码代理必须具有终端节点的网络访问权限。

**正在连接亚马逊 ElastiCache：**V ElastiCache alkey 集群位于私有 VPC 中，无法直接从本地计算机访问。有关 SSM 隧道设置、IAM 身份验证令牌生成和隧道模式下的 TLS 处理，请参阅 AWS 代理工具包中的[ElastiCache 连接指南](https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/database-skills/amazon-elasticache/references/setup/connection-guide.md)，或者安装 A [mazon Sk ElastiCache il](agent-tools-skills.md) l 让您的代理端到端地处理连接设置。隧道建立后，`VALKEY_HOST=127.0.0.1`在上面的配置中使用。

保存配置后重新启动 MCP 客户端。

您可以通过以下方式提示您的代理验证连接：

*使用 Valkey MCP 服务器验证与我的数据存储的连接并确认 Valkey 操作是否可用。*

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

通过 MCP 客户端配置中的环境变量配置 Valkey MCP 服务器。您也可以使用该`--readonly`标志将代理访问权限限制为只读操作。


<table>
<thead>
  <tr><th>变量</th><th>用途</th></tr>
</thead>
<tbody>
  <tr><td>VALKEY\_HOST</td><td>指定您的 Valkey 数据存储库的端点。在通过隧道连接到私有 ElastiCache 集群127.0.0.1时使用。</td></tr>
  <tr><td>VALKEY\_USE\_SSL</td><td>设置true为可启用 TLS。对于启用传输中加密的 ElastiCache 集群，这是必需的。</td></tr>
  <tr><td>--readonly</td><td>将服务器限制在读取层并禁用所有写入和管理工具，使其适合生产探索。</td></tr>
  <tr><td colspan="2">可选搜索参数</td></tr>
  <tr><td>EMBEDDINGS\_PROVIDER</td><td>选择add\_documents和使用的嵌入提供程序search。支持的选项有bedrockopenai、ollama、和hash。无需凭证即可hash用于本地测试。</td></tr>
  <tr><td>BEDROCK\_MODEL\_ID</td><td>覆盖默认的 Amazon Bedrock 嵌入模型。</td></tr>
  <tr><td>OPENAI\_API\_KEY</td><td>提供设置为时所需EMBEDDING\_PROVIDER的 API 密钥openai。</td></tr>
</tbody>
</table>