使用说明
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许可证 由您选择。
