Redis MCP Server

Redis 数据库的 MCP 服务器实现，采用三工具模式：read、write、admin。

功能特性

• ✅ 3 个工具：read (读), write (写), admin (管理)
• ✅ 统一权限控制：通过 MCP_PERMISSIONS 配置
• ✅ 命令白名单验证：确保 LLM 生成的命令安全
• ✅ 使用 ioredis 驱动

权限配置

通过环境变量 MCP_PERMISSIONS 配置权限，支持两种格式：

# JSON 数组格式
MCP_PERMISSIONS='["read","write"]'

# 逗号分隔格式
MCP_PERMISSIONS='read,write'

| 权限 | 默认值 | 说明 | |------|--------|------| | read | ✅ 开启 | GET, HGET, SCAN 等读命令 | | write | ❌ 关闭 | SET, HSET, DEL 等写命令 | | admin | ❌ 关闭 | FLUSHDB, CONFIG 等管理命令（危险） |

工具说明

| 工具 | 命令类型 | 说明 | |------|----------|------| | read | GET, HGET, SMEMBERS, SCAN 等 | 执行 Redis 读命令 | | write | SET, HSET, DEL, SADD 等 | 执行 Redis 写命令 | | admin | FLUSHDB, CONFIG 等 | 执行 Redis 管理命令（危险操作，默认禁用） |

环境变量

# 方式1：分别配置
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=password
REDIS_DATABASE=0  # 可选，默认 0

# 方式2：直接配置 URL（优先使用）
REDIS_URL=redis://:password@host:port/database

# TLS 配置（Upstash 等云 Redis）
REDIS_URL=rediss://default:pass@host:6379
REDIS_TLS=true

MCP_PERMISSIONS='["read","write"]'  # 可选，默认只有 read

URL 格式示例：

redis://:[email protected]:6479/0
redis://localhost:6379                    # 无密码
redis://localhost:6379/1                 # 选择数据库 1
rediss://default:pass@host:6379          # TLS 加密（Upstash 等）

TLS 配置（适配 Upstash 等云 Redis）

通过 REDIS_TLS 或 REDIS_SSL 环境变量启用 TLS：

| 取值 | 行为 | |------|------| | true | 启用 TLS 加密 |

配置示例：

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["-y", "@easy-mcps/redis-mcp-server"],
      "env": {
        "REDIS_URL": "rediss://default:pass@host:6379",
        "REDIS_TLS": "true",
        "MCP_PERMISSIONS": "read,write"
      }
    }
  }
}

支持的命令

读命令 (read)

GET, HGET, HGETALL, HMGET, SMEMBERS, SRANDMEMBER, LRANGE, ZRANGE, ZREVRANGE, ZSCORE, ZCARD, TYPE, TTL, PTTL, EXISTS, DBSIZE, INFO, SCAN, KEYS, CLIENT, PING, ECHO, MULTI, EXPIRE, HKEYS, HVALS, HLEN, HEXISTS, LLEN, SCARD 等

写命令 (write)

SET, SETEX, SETNX, MSET, MSETNX, HSET, HMSET, HSETNX, HDEL, HINCRBY, HINCRBYFLOAT, DEL, UNLINK, SADD, SREM, SPOP, SMOVE, LPUSH, RPUSH, LPOP, RPOP, LTRIM, LREM, LSET, LINSERT, ZADD, ZREM, ZINCRBY, ZREMRANGEBYRANK, ZREMRANGEBYSCORE, INCR, INCRBY, INCRBYFLOAT, DECR, DECRBY, APPEND, SETRANGE, GETSET, PUBLISH, EXPIRE, EXPIREAT, MOVE, RENAME, RENAMENX 等

管理命令 (admin)

FLUSHDB, FLUSHALL, CONFIG, SHUTDOWN, SLAVEOF, REPLICAOF, BGREWRITEAOF, BGSAVE, SAVE, CLIENT, DEBUG 等（危险操作，默认禁用）

使用方式

npx 直接运行

npx -y @easy-mcps/redis-mcp-server

带 TLS 运行（Upstash 等云 Redis）：

REDIS_URL=rediss://default:pass@host:6379 REDIS_TLS=true npx -y @easy-mcps/redis-mcp-server

Claude Desktop / Cursor

基础配置：

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["-y", "@easy-mcps/redis-mcp-server"],
      "env": {
        "REDIS_HOST": "localhost",
        "REDIS_PORT": "6379",
        "REDIS_PASSWORD": "",
        "MCP_PERMISSIONS": "read,write"
      }
    }
  }
}

TLS 配置（Upstash 等云 Redis）：

方式1：URL + TLS

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["-y", "@easy-mcps/redis-mcp-server"],
      "env": {
        "REDIS_URL": "rediss://default:pass@host:6379",
        "REDIS_TLS": "true",
        "MCP_PERMISSIONS": "read,write"
      }
    }
  }
}

方式2：独立变量 + TLS

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["-y", "@easy-mcps/redis-mcp-server"],
      "env": {
        "REDIS_HOST": "host",
        "REDIS_PORT": "6379",
        "REDIS_PASSWORD": "password",
        "REDIS_TLS": "true",
        "MCP_PERMISSIONS": "read,write"
      }
    }
  }
}

本地安装

npm install -g @easy-mcps/redis-mcp-server
redis-mcp-server

开发

npm install
npm run dev

License

MIT