本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 開始使用
<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 資料存放區的端點。您的編碼代理程式必須具有端點的網路存取權。

**連線至 Amazon ElastiCache：**ElastiCache Valkey 叢集位於私有 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)，或安裝 [Amazon ElastiCache 技能](agent-tools-skills.md)，讓您的代理程式end-to-end處理連線設定。通道建立後，請在上述組態`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。支援的選項為 bedrock、ollama、 openai和 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>