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

# Valkey MCP 伺服器的運作方式
<a name="agent-tools-valkey-mcp-how-it-works"></a>

Valkey MCP 伺服器為您的代理程式提供一組結構化工具，以使用設定的 Valkey 資料存放區。當您提出請求時，代理程式會選取適當的工具、提供必要的參數，並直接從 Valkey 接收結果。伺服器會處理命令建構和驗證，因此代理程式不需要產生用戶端程式碼或手動格式化 Valkey 命令。

Valkey MCP 伺服器提供下列功能區域：


| 功能區域 | 用途 | 
| --- | --- | 
| Valkey 操作 | 讀取和修改字串、雜湊、清單、集合、排序集合、串流和其他 Valkey 資料結構。 | 
| JSON 操作 | 使用結構化路徑存放、擷取和更新 JSON 文件和陣列。 | 
| 搜尋和 AI 工作負載 | 建立搜尋索引、新增文件、執行文字、語意、向量和混合搜尋，以及彙總結果。 | 
| 操作防護措施 | 分隔讀取、寫入和管理操作。預設會停用破壞性管理命令，且伺服器可以唯讀模式執行。 | 

伺服器使用結構化 JSON 輸入，並將其轉換為適當的 Valkey 操作。這可減少命令格式錯誤，並為代理程式提供跨常用資料、搜尋和操作任務的一致界面。

## 透過精簡的工具表面完整存取 Valkey
<a name="agent-tools-valkey-mcp-full-access"></a>

Valkey MCP 伺服器可讓客服人員透過三種結構化工具存取完整的 Valkey 命令集：

1. `valkey_read` 處理唯讀操作，例如 `GET`、`SCAN`、 `HGETALL`和 `INFO`。

1. `valkey_write` 支援變動，例如 `SET`、`DEL`、 `HSET`和 `LPUSH`。

1. `valkey_admin` 涵蓋組態和高影響的操作。

這可讓代理程式的工具表面變得簡單，同時支援 Valkey 功能，例如字串、雜湊、清單、排序集、串流、pub/sub、點陣圖、HyperLogLog 等。

## 簡化 AI、搜尋和分析工作流程
<a name="agent-tools-valkey-mcp-search-ai"></a>

Valkey MCP 伺服器提供四種專用工具，用於向量、語意、文字和混合搜尋，以及彙總。客服人員可以在不建構低階命令的情況下查詢資料，為開發人員提供從自然語言請求到運作中 Valkey 搜尋或 AI 工作流程的直接路徑。

1. `manage_index` 可讓客服人員建立、捨棄、檢查或列出搜尋索引。

1. `add_documents` 將文件擷取至搜尋索引，如果不存在，則會自動建立索引。它還支援選用的語意搜尋內嵌產生，預設使用開放原始碼內嵌套件和可設定的提供者，例如 Amazon Bedrock、OpenAI 或 Ollama。

1. `search` 為語意、文字、混合和尋找類似搜尋提供統一的界面。它會自動從提供的參數偵測搜尋模式。

1. `aggregate` 為 提供結構化管道建置器`FT.AGGREGATE`，並支援 `GROUPBY`、`SORTBY`、`FILTER`、 `APPLY`和 `LIMIT`階段。

偵錯時， `search`和 `aggregate`工具可讓客服人員檢查資料存放區的實際內容。客服人員可以檢閱索引資料、範例比對文件，以及直接在對話中驗證搜尋和彙總結果。