Redis MCP 服务器

概述

Redis MCP 服务器是一个自然语言接口，专为代理应用程序设计，用于高效地管理和搜索 Redis 中的数据。它与 MCP (模型内容协议) 客户端无缝集成，使 AI 驱动的工作流程能够与 Redis 中的结构化和非结构化数据进行交互。使用此 MCP 服务器，您可以提出如下问题：

• "将整个对话存储在一个流中"
• "缓存此项目"
• "存储带有过期时间的会话"
• "索引并搜索此向量"

特性

• 自然语言查询: 使 AI 代理能够使用自然语言查询和更新 Redis。
• 无缝 MCP 集成: 与任何 MCP 客户端配合使用，实现流畅的通信。
• 完整 Redis 支持: 处理 哈希、列表、集合、有序集合、流 等。
• 搜索与过滤: 支持在 Redis 中高效的数据检索和搜索。
• 可扩展且轻量级: 专为 高性能 数据操作而设计。

工具

此 MCP 服务器提供用于管理存储在 Redis 中的数据的工具。

• string 工具，用于设置、获取带有过期时间的字符串。适用于存储简单的配置值、会话数据或缓存响应。
• hash 工具，用于在单个键中存储字段-值对。哈希可以存储向量嵌入。适用于表示具有多个属性的对象、用户配置文件或产品信息，其中可以单独访问字段。
• list 工具，具有用于追加和弹出项目的常用操作。适用于队列、消息代理或维护最近操作的列表。
• set 工具，用于添加、删除和列出集合成员。适用于跟踪唯一值（如用户 ID 或标签），以及执行集合操作（如交集）。
• sorted set 工具，用于管理数据，例如排行榜、优先级队列或基于分数的排序的基于时间的分析。
• pub/sub 功能，用于将消息发布到通道并订阅以接收它们。适用于实时通知、聊天应用程序或将更新分发给多个客户端。
• streams 工具，用于从数据流中添加、读取和删除。适用于事件溯源、活动提要或具有消费者组支持的传感器数据记录。
• JSON 工具，用于在 Redis 中存储、检索和操作 JSON 文档。适用于复杂的嵌套数据结构、文档数据库或具有基于路径的访问的配置管理。

其他工具。

• query engine 工具，用于管理向量索引并执行向量搜索
• server management 工具，用于检索有关数据库的信息

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Redis MCP 服务器：

npx -y @smithery/cli install @redis/mcp-redis --client claude

手动安装

# 克隆存储库
git clone https://github.com/redis/mcp-redis.git
cd mcp-redis

# 使用 uv 安装依赖项
uv venv
source .venv/bin/activate
uv sync

配置

要配置此 Redis MCP 服务器，请考虑以下环境变量：

名称	描述	默认值
REDIS_HOST	Redis IP 或主机名	"127.0.0.1"
REDIS_PORT	Redis 端口	6379
REDIS_USERNAME	默认数据库用户名	"default"
REDIS_PWD	默认数据库密码	""
REDIS_SSL	启用或禁用 SSL/TLS	False
REDIS_CA_PATH	用于验证服务器的 CA 证书	None
REDIS_SSL_KEYFILE	用于客户端身份验证的客户端私钥文件	None
REDIS_SSL_CERTFILE	用于客户端身份验证的客户端证书文件	None
REDIS_CERT_REQS	客户端是否应验证服务器的证书	"required"
REDIS_CA_CERTS	受信任的 CA 证书文件的路径	None

与 OpenAI Agents SDK 集成

将此 MCP 服务器与 OpenAI Agents SDK 集成。阅读文档以了解有关 SDK 与 MCP 集成的更多信息。

安装 Python SDK。

pip install openai-agents

配置 OpenAI 令牌：

export OPENAI_API_KEY="<openai_token>"

并运行 应用程序。

python3.13 redis_assistant.py

您可以使用 OpenAI 仪表板 对您的代理工作流程进行故障排除。

与 Claude Desktop 集成

您可以配置 Claude Desktop 以使用此 MCP 服务器。

1. 指定您的 Redis 凭据和 TLS 配置
2. 检索您的 uv 命令完整路径（例如 which uv）
3. 编辑 claude_desktop_config.json 配置文件
   • 在 MacOS 上，位于 ~/Library/Application\ Support/Claude/

{
    "mcpServers": {
        "redis": {
            "command": "<full_path_uv_command>",
            "args": [
                "--directory",
                "<your_mcp_server_directory>",
                "run",
                "src/main.py"
            ],
            "env": {
                "REDIS_HOST": "<your_redis_database_hostname>",
                "REDIS_PORT": "<your_redis_database_port>",
                "REDIS_PSW": "<your_redis_database_password>",
                "REDIS_SSL": True|False,
                "REDIS_CA_PATH": "<your_redis_ca_path>"
            }
        }
    }
}

您可以通过跟踪日志文件来排除问题。

tail -f ~/Library/Logs/Claude/mcp-server-redis.log

测试

您可以使用 MCP Inspector 对此 MCP 服务器进行可视化调试。

npx @modelcontextprotocol/inspector uv run src/main.py

示例用例

• AI 助手: 使 LLM 能够获取、存储和处理 Redis 中的数据。
• 聊天机器人和虚拟代理: 检索会话数据、管理队列和个性化响应。
• 数据搜索与分析: 查询 Redis 以获得 实时洞察和快速查找。
• 事件处理: 使用 Redis Streams 管理事件流。

贡献

1. Fork 仓库
2. 创建一个新分支 (feature-branch)
3. 提交您的更改
4. 推送到您的分支并提交 PR！

许可证

本项目根据 MIT 许可证 获得许可。

联系方式

如有问题或需要支持，请通过 GitHub Issues 联系。