Redis 模型上下文协议 (MCP) 服务器 (@gongrzhe/server-redis-mcp@1.0.0)

一个 Redis 模型上下文协议 (MCP) 服务器实现，用于与 Redis 数据库交互。此服务器通过一组标准化工具使大型语言模型 (LLMs) 能够与 Redis 键值存储进行交互。

安装与使用

使用 Smithery 进行安装

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

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

手动安装

# 使用 npx 指定版本（推荐）
npx @gongrzhe/server-redis-mcp@1.0.0 redis://your-redis-host:port

# 示例：
npx @gongrzhe/server-redis-mcp@1.0.0 redis://localhost:6379

或者全局安装：

# 全局安装指定版本
npm install -g @gongrzhe/server-redis-mcp@1.0.0

# 安装后运行
@gongrzhe/server-redis-mcp redis://your-redis-host:port

组件

工具

• 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" 部分添加以下配置：

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-redis-mcp@1.0.0",
        "redis://localhost:6379"
      ]
    }
  }
}

或者，如果您已安装该包，则可以直接使用 node 命令：

{
  "mcpServers": {
    "redis": {
      "command": "node",
      "args": [
        "path/to/build/index.js",
        "redis://10.1.210.223:6379"
      ]
    }
  }
}

Docker 使用

使用 Docker 时：

• 对于 macOS，请在 Redis 服务器运行在主机网络时使用 host.docker.internal
• Redis URL 可以指定为参数，默认为 "redis://localhost:6379"

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

构建与测试

要构建项目，请运行：

npm run build

然后使用以下命令启动服务器：

node dist/index.js redis://localhost:6379

许可证

请查看项目的许可证文件以获取详细信息。