Redis

一个模型上下文协议服务器，提供对Redis数据库的访问。该服务器允许大型语言模型（LLM）通过一组标准化工具与Redis键值存储进行交互。

预备条件

1. 必须安装并运行Redis服务器
   • 下载Redis
   • 对于Windows用户：使用Windows Linux子系统 (WSL) 或Memurai（兼容Redis的Windows服务器）
   • 默认端口：6379

常见问题及解决方案

连接错误

ECONNREFUSED

• 原因: Redis/Memurai服务器未运行或不可访问
• 解决方案:
  • 验证服务器是否正在运行：
    • Redis：redis-cli ping 应返回 "PONG"
    • Memurai (Windows)：memurai-cli ping 应返回 "PONG"
  • 检查服务状态：
    • Linux：systemctl status redis
    • macOS：brew services list
    • Windows：在服务中检查Memurai (services.msc)
  • 确保防火墙未阻止正确的端口（默认6379）
  • 验证Redis URL格式：redis://hostname:port
  • 如果redis://localhost:6379 返回ECONNREFUSED错误，尝试使用显式IP：redis://127.0.0.1:6379

服务器行为

• 服务器实现指数退避，最多重试5次
• 初始重试延迟：1秒，最大延迟：30秒
• 服务器将在最大重试次数后退出，以防止无限重连循环

组件

工具

• set

  • 设置Redis键值对，可以选择设置过期时间
  • 输入：
    • key (字符串): Redis键
    • value (字符串): 要存储的值
    • expireSeconds (数字，可选): 过期时间（秒）

• get

  • 通过键从 Redis 获取值
  • 输入：key (字符串)：要检索的 Redis 键

• delete

  • 从 Redis 中删除一个或多个键
  • 输入：key (字符串 | 字符串数组)：要删除的键或键数组

• list

  • 列出与模式匹配的 Redis 键
  • 输入：pattern (字符串，可选)：与键匹配的模式（默认：*）

在 Claude Desktop 中使用

要在 Claude Desktop 应用中使用此服务器，请将以下配置添加到 claude_desktop_config.json 文件的 "mcpServers" 部分：

Docker

• 在 macOS 上运行 Docker 时，如果服务器运行在主机网络（例如 localhost）上，请使用 host.docker.internal
• Redis URL 可以作为参数指定，默认为 "redis://localhost:6379"（如果 localhost 失败，请使用 "redis://127.0.0.1:6379"）

{
  "mcpServers": {
    "redis": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/redis", 
        "redis://host.docker.internal:6379"]
    }
  }
}

NPX

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-redis",
        "redis://localhost:6379"
      ]
    }
  }
}

在 VS Code 中使用

为了快速安装，请使用以下一键安装按钮之一...

手动安装：在 VS Code 中，将以下 JSON 代码块添加到您的用户设置 (JSON) 文件中。您可以按 Ctrl + Shift + P 并键入 Preferences: Open User Settings (JSON) 来完成此操作。

或者，您可以将其添加到工作区中的 .vscode/mcp.json 文件中。这允许您与他人共享配置。

请注意，.vscode/mcp.json 文件中不需要 mcp 键。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "redis_url",
        "description": "Redis URL (例如 redis://localhost:6379)"
      }
    ],
    "servers": {
      "redis": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-redis"],
        "env": {
          "REDIS_URL": "${input:redis_url}"
        }
      }
    }
  }
}

Docker安装：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "redis_url",
        "description": "Redis URL (例如 redis://host.docker.internal:6379)"
      }
    ],
    "servers": {
      "redis": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/redis"],
        "env": {
          "REDIS_URL": "${input:redis_url}"
        }
      }
    }
  }
}

许可证

此 MCP 服务器采用 MIT 许可证授权。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。