Redis

Redis

site icon
2025.04.20 85000
JavaScriptRedis接口数据库中间件数据库
Redis MCP服务器是一个基于Model Context Protocol的服务,提供对Redis数据库的访问能力。它使LLMs(大型语言模型)能够通过一组标准化工具与Redis键值存储进行交互。该服务器支持基本的Redis操作,如设置、获取、删除和列出键值对,并具备错误处理和重试机制。
View on GitHub

Overview

基本能力

产品定位

Redis MCP服务器是一个中间件服务,旨在为大型语言模型提供与Redis数据库交互的能力。

核心功能

  • 键值操作:支持设置、获取、删除和列出Redis中的键值对。
  • 错误处理:实现指数退避重试机制,最多重试5次。
  • 连接管理:支持多种连接方式,包括本地和Docker环境。

适用场景

  • 需要将LLMs与Redis数据库集成的应用场景。
  • 需要标准化接口访问Redis的服务。
  • 开发环境中需要快速测试Redis交互的场景。

工具列表

  • set:设置Redis键值对,可选设置过期时间。
  • get:根据键获取Redis中的值。
  • delete:删除一个或多个Redis键。
  • list:列出匹配模式的Redis键。

常见问题解答

  • 连接问题
  • 确保Redis服务器正在运行(使用redis-cli ping检查)。
  • 检查防火墙是否阻止了默认端口6379。
  • 如果localhost连接失败,尝试使用127.0.0.1
  • 服务器行为
  • 服务器会实施指数退避重试,初始延迟1秒,最大延迟30秒。
  • 达到最大重试次数后会退出以防止无限重试循环。

使用教程

使用依赖

  1. 安装并运行Redis服务器
  2. Linux/macOS: sudo apt-get install redis-serverbrew install redis
  3. Windows: 使用WSL或Memurai
  4. 验证Redis运行状态: sh redis-cli ping 应返回"PONG"

安装教程

Docker方式

docker build -t mcp/redis -f src/redis/Dockerfile .

NPX方式

npx -y @modelcontextprotocol/server-redis redis://localhost:6379

调试方式

  1. 检查服务状态:
  2. Linux: systemctl status redis
  3. macOS: brew services list
  4. Windows: 检查Memurai服务状态
  5. 测试连接: sh redis-cli ping
  6. 查看日志:
  7. Docker容器日志
  8. Redis服务器日志

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。