Redis数据库交互工具

MCP服务器允许LLMs与Redis和Valkey数据库交互,默认只读且支持多实例。

  • by mehdig-dev
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 mehdig-dev/mcp-redis

使用说明

mcp-redis

MCP服务器,允许LLM与Redis和Valkey数据库交互。单二进制,默认只读,多实例。

安装

cargo install mcp-redis

用法

# Default (localhost:6379)
mcp-redis

# Specific instance
mcp-redis --url redis://myhost:6379

# With password
mcp-redis --url redis://:password@host:6379

# Multiple instances
mcp-redis --url redis://host1:6379 --url redis://host2:6379

# From environment variable
mcp-redis --url-env REDIS_URL

# Enable write operations
mcp-redis --url redis://host:6379 --allow-write

配置

克劳德代码

claude mcp add redis -- mcp-redis --url redis://localhost:6379

克劳德桌面

{
  "mcpServers": {
    "redis": {
      "command": "mcp-redis",
      "args": ["--url", "redis://localhost:6379"]
    }
  }
}

光标/VS代码

{
  "mcpServers": {
    "redis": {
      "command": "mcp-redis",
      "args": ["--url", "redis://localhost:6379"]
    }
  }
}

工具

工具 说明
list_connections 显示所有连接的Redis实例(密码已编辑)
info 获取Redis服务器信息(内存、统计数据、密钥空间等)
scan_keys 使用Scan(非阻塞)扫描与模式匹配的按键
get 获取键值,自动检测类型(string/hash/list/set/zset)
key_info 获取密钥元数据:类型、TTL、编码、内存使用情况
dbsize 获取当前数据库中的键数
search_keys 扫描带有图案的按键,并返回按键类型

所有工具都接受可选 connection 多个实例连接时的参数。

CLI选项

标志 默认值 描述
--url redis://127.0.0.1:6379 Redis连接URL(可重复)
--url-env -- 从环境变量中读取Redis URL(可重复)
--allow-write false 启用写入操作
--scan-count 100 每次SCAN迭代的最大密钥数

安全

  • 默认情况下为只读 --只允许读取命令
  • 扫描钥匙 --使用非阻塞SCAN来避免阻塞Redis
  • 已编辑凭据 --密码被屏蔽 list_connections 输出
  • 连接池 --使用ConnectionManager自动重新连接

许可证

根据以下任一方式获得许可 Apache许可证,版本2.0 或 MIT许可证 由您选择。