本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Valkey MCP 伺服器的運作方式
Valkey MCP 伺服器為您的代理程式提供一組結構化工具，以使用設定的 Valkey 資料存放區。當您提出請求時，代理程式會選取適當的工具、提供必要的參數，並直接從 Valkey 接收結果。伺服器會處理命令建構和驗證，因此代理程式不需要產生用戶端程式碼或手動格式化 Valkey 命令。
Valkey MCP 伺服器提供下列功能區域：
| 功能區域 | 用途 |
|---|---|
| Valkey 操作 | 讀取和修改字串、雜湊、清單、集合、排序集合、串流和其他 Valkey 資料結構。 |
| JSON 操作 | 使用結構化路徑存放、擷取和更新 JSON 文件和陣列。 |
| 搜尋和 AI 工作負載 | 建立搜尋索引、新增文件、執行文字、語意、向量和混合搜尋，以及彙總結果。 |
| 操作防護措施 | 分隔讀取、寫入和管理操作。預設會停用破壞性管理命令，且伺服器可以唯讀模式執行。 |
伺服器使用結構化 JSON 輸入，並將其轉換為適當的 Valkey 操作。這可減少命令格式錯誤，並為代理程式提供跨常用資料、搜尋和操作任務的一致界面。
透過精簡的工具表面完整存取 Valkey
Valkey MCP 伺服器可讓客服人員透過三種結構化工具存取完整的 Valkey 命令集：
valkey_read處理唯讀操作，例如GET、SCAN、HGETALL和INFO。valkey_write支援變動，例如SET、DEL、HSET和LPUSH。valkey_admin涵蓋組態和高影響的操作。
這可讓代理程式的工具表面變得簡單，同時支援 Valkey 功能，例如字串、雜湊、清單、排序集、串流、pub/sub、點陣圖、HyperLogLog 等。
簡化 AI、搜尋和分析工作流程
Valkey MCP 伺服器提供四種專用工具，用於向量、語意、文字和混合搜尋，以及彙總。客服人員可以在不建構低階命令的情況下查詢資料，為開發人員提供從自然語言請求到運作中 Valkey 搜尋或 AI 工作流程的直接路徑。
manage_index可讓客服人員建立、捨棄、檢查或列出搜尋索引。add_documents將文件擷取至搜尋索引，如果不存在，則會自動建立索引。它還支援選用的語意搜尋內嵌產生，預設使用開放原始碼內嵌套件和可設定的提供者，例如 Amazon Bedrock、OpenAI 或 Ollama。search為語意、文字、混合和尋找類似搜尋提供統一的界面。它會自動從提供的參數偵測搜尋模式。aggregate為 提供結構化管道建置器FT.AGGREGATE，並支援GROUPBY、SORTBY、FILTER、APPLY和LIMIT階段。
偵錯時， search和 aggregate工具可讓客服人員檢查資料存放區的實際內容。客服人員可以檢閱索引資料、範例比對文件，以及直接在對話中驗證搜尋和彙總結果。
