AI导哈

Redis数据库访问工具

一个提供Redis数据库访问的协议服务器，使LLM能够通过标准化工具与Redis键值存储进行交互。

  • by modelcontextprotocol
  • JavaScript
  • 本地部署
  • 305 星标
  • 更新于
在 GitHub 查看 modelcontextprotocol/servers-archived

使用说明

瑞迪斯

提供对Redis数据库访问的模型上下文协议服务器。该服务器使LLM能够通过一组标准化的工具与Redis键值存储进行交互。

先决条件

  1. Redis服务器必须安装并运行

常见问题及解决方案

连接错误

连接被拒绝

  • 原因：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）
    • 验证重定向URL格式： redis://hostname:port
    • 如果 redis://localhost:6379 使用ECONNREFUSED失败，请尝试使用显式IP： redis://127.0.0.1:6379

服务器行为

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

组件

工具

  • 集

    • 设置一个可选过期的Redis键值对
    • 输入：
      • key （string）：Redis密钥
      • value （string）：要存储的值
      • expireSeconds （数字，可选）：到期时间（秒）

  • 得到

    • 从Redis按键获取值
    • 输入： key （string）：要检索的Redis密钥

  • 删除

    • 从Redis中删除一个或多个密钥
    • 输入： key （string | string[]）：要删除的键或键数组

  • 列表

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

使用Claude Desktop

要将此服务器与Claude Desktop应用程序一起使用，请将以下配置添加到您的“mcpServers”部分 claude_desktop_config.json:

码头工人

  • 在macos上运行docker时，如果服务器在主机网络上运行（例如localhost），请使用host.docker.internal
  • Redis URL可以指定为参数，默认为“redis://localhost:6379“（使用”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代码

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

对于手动安装，请将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以按 Ctrl + Shift + P 和打字 Preferences: Open User Settings (JSON).

您可以选择将其添加到名为的文件中 .vscode/mcp.json 在您的工作空间中。这将允许您与他人共享配置。

请注意 mcp 中不需要密钥 .vscode/mcp.json 文件。

{
  "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文件。

相关 MCP