View a markdown version of this page

開始使用 - Amazon ElastiCache

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

開始使用

安裝

先決條件:Python 3.10 或更新版本、uv、存取 Valkey 資料存放區

設定 MCP 用戶端:將下列項目新增至 MCP 用戶端組態:

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

<your-endpoint> 將 取代為 Valkey 資料存放區的端點。您的編碼代理程式必須具有端點的網路存取權。

連線至 Amazon ElastiCache:ElastiCache Valkey 叢集位於私有 VPC 中,無法直接從本機電腦連線。如需通道模式中的 SSM 通道設定、IAM 驗證字符產生和 TLS 處理,請參閱 AWS 代理程式工具組中的 ElastiCache 連線指南,或安裝 Amazon ElastiCache 技能,讓您的代理程式end-to-end處理連線設定。通道建立後,請在上述組態VALKEY_HOST=127.0.0.1中使用 。

儲存組態後重新啟動 MCP 用戶端。

您可以提示代理程式驗證與下列項目的連線:

使用 Valkey MCP 伺服器來驗證與資料存放區的連線,並確認 Valkey 操作可用。

組態

透過 MCP 用戶端組態中的環境變數來設定 Valkey MCP 伺服器。您也可以使用 --readonly旗標來限制客服人員對唯讀操作的存取。

變數 用途
VALKEY_HOST 指定您的 Valkey 資料存放區的端點。透過通道連線至私有 ElastiCache 叢集127.0.0.1時使用 。
VALKEY_USE_SSL 設定為 true以啟用 TLS。對於啟用傳輸中加密的 ElastiCache 叢集,這是必要的。
--readonly 將伺服器限制為讀取層,並停用所有寫入和管理工具,使其適合用於生產探索。
選用搜尋參數
EMBEDDINGS_PROVIDER 選取 add_documents和 使用的內嵌提供者search。支援的選項為 bedrockollamaopenaihash。使用 hash 進行沒有登入資料的本機測試。
BEDROCK_MODEL_ID 覆寫預設的 Amazon Bedrock 內嵌模型。
OPENAI_API_KEY 提供將 EMBEDDING_PROVIDER 設定為 時所需的 API 金鑰openai