Usage

基本能力

产品定位

prajwalnayak7_mcp-server-redis 是一个 Redis 数据库集成服务，通过 MCP 协议提供对 Redis 的操作能力。

核心功能

• 资源管理
• redis://status - 当前连接状态
• redis://info - Redis 服务器信息

• redis://keys/{pattern} - 列出匹配模式的键

• 工具功能

• 基本操作：获取值、设置值、删除键、递增数值
• 列表操作：推送值到列表、获取列表范围值
• 哈希操作：设置哈希字段、获取哈希字段
• 集合操作：添加到集合、获取集合成员
• 发布/订阅：发布消息

适用场景

• Redis 数据库管理
• 缓存系统集成
• 消息队列实现
• 实时数据处理

使用教程

使用依赖

1. 安装 uv（如果尚未安装）：https://docs.astral.sh/uv/
2. 创建虚拟环境：

uv venv
source .venv/bin/activate

1. 同步依赖：

uv sync

安装教程

1. 配置 Redis 连接（参考 .env.example 文件）
2. 运行服务器：

python src/server.py

调试方式

1. 使用 MCP Inspector 测试：

mcp dev src/server.py

1. 安装到 Claude Desktop：

mcp install src/server.py

工具列表

• basic.py：基本 Redis 操作
• lists.py：列表操作
• hashes.py：哈希操作
• sets.py：集合操作
• pubsub.py：发布/订阅操作

常见问题解答

1. 如何检查 Redis 连接状态？ 访问 redis://status 资源

2. 如何存储和检索数据？ 使用 set_value 和 get_value 工具

3. 服务器断开连接怎么办？ 服务会自动重新连接到 Redis

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。