Redis MCP Server Configuration & Usage Guide

Supported Clients

• Claude Desktop
• Cursor

Installation Command

npx -y @redis/mcp-server

Configuration Example

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

Environment variable required：REDIS_URL。Do not commit these values to public repositories.

Permission Scope & Security Notes

可读写 Redis 数据，建议连接本地开发实例而非生产环境

• database-read
• database-write
• network-access

Risk Score：5/10

Common Errors

连接被拒绝

确认 Redis 服务运行中且端口正确

认证失败

如果 Redis 设置了密码，在 URL 中包含密码

Sources

• Official Documentation / Repository

Recently Verified：2026-05-18。Client versions and configuration formats may change. Please refer to official documentation before use.

Related Tools