Redis

一个提供对Redis数据库访问的Model Context Protocol服务器。此服务器使LLMs能够通过一组标准化工具与Redis键值存储进行交互。

预备条件

1. 必须安装并运行Redis服务器
   • 下载Redis
   • 对于Windows用户：使用Windows Subsystem for Linux (WSL) 或 Memurai（兼容Windows的Redis服务器）
   • 默认端口：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 (e.g. 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 (e.g. 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文件。