本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
Valkey MCP 服务器的工作原理
Valkey MCP 服务器为您的代理提供了一组结构化工具，用于处理已配置的 Valkey 数据存储。当您提出请求时，代理会选择相应的工具，提供所需的参数，然后直接从 Valkey 接收结果。服务器负责命令的构造和验证，因此代理无需生成客户端代码或手动格式化 Valkey 命令。
Valkey MCP 服务器提供以下功能区域：
| 能力区域 | 用途 |
|---|---|
| Valkey 行动 | 读取和修改字符串、哈希、列表、集合、排序集合、流和其他 Valkey 数据结构。 |
| JSON 操作 | 使用结构化路径存储、检索和更新 JSON 文档和数组。 |
| 搜索和 AI 工作负载 | 创建搜索索引、添加文档、运行文本、语义、矢量和混合搜索，以及汇总结果。 |
| 操作保障 | 将读取、写入和管理操作分开。默认情况下，破坏性管理命令处于禁用状态，并且服务器可以在只读模式下运行。 |
服务器使用结构化的 JSON 输入并将其转换为相应的 Valkey 操作。这减少了命令格式错误，并为代理提供了跨常用数据、搜索和操作任务的一致界面。
通过紧凑的工具表面完全进入 Valkey
Valkey MCP 服务器允许代理通过三个结构化工具访问完整的 Valkey 命令集：
valkey_read处理只读操作GET，例如HGETALL、SCAN、和INFO。valkey_write支持诸如SET、HSETDEL、和LPUSH之类的突变。valkey_admin涵盖配置和高影响力操作。
这使代理的工具表面变得简单，同时支持字符串、哈希、列表、排序集、流 pub/sub、位图等 Valkey 功能。 HyperLogLog
简化的 AI、搜索和分析工作流程
Valkey MCP 服务器为矢量搜索、语义搜索、文本搜索和混合搜索以及聚合提供了四种专门构建的工具。代理无需构建低级命令即可查询您的数据，这为开发人员提供了从自然语言请求到有效的 Valkey 搜索或 AI 工作流程的直接路径。
manage_index允许代理创建、删除、检查或列出搜索索引。add_documents将文档提取到搜索索引中，如果索引不存在，则自动创建该索引。它还支持用于语义搜索的可选嵌入生成，默认使用开源嵌入包和可配置的提供程序，例如Amazon Bedrock、OpenAI或Ollama。search为语义、文本、混合搜索和查找相似搜索提供了统一的接口。它会根据提供的参数自动检测搜索模式。aggregate为结构化管道生成器提供支持GROUPBY、SORTBYAPPLY、FILTER、和LIMIT阶段。FT.AGGREGATE
调试时，search和aggregate工具允许代理检查数据存储的实际内容。客服人员可以直接在对话中查看索引数据、对匹配文档进行样本以及验证搜索和聚合结果。
