本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
開始使用
安裝
先決條件: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 連線指南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。支援的選項為 bedrock、ollama、 openai和 hash。使用 hash 進行沒有登入資料的本機測試。 |
BEDROCK_MODEL_ID |
覆寫預設的 Amazon Bedrock 內嵌模型。 |
OPENAI_API_KEY |
提供將 EMBEDDING_PROVIDER 設定為 時所需的 API 金鑰openai。 |