MCP Server Redis

用法

结构如下：

mcp-server-redis/
├── src/
│   ├── __init__.py
│   ├── main.py           # 主入口点
│   ├── config.py         # 配置
│   ├── connection.py     # Redis 连接管理
│   ├── resources/        # 资源实现
│   │   ├── __init__.py
│   │   ├── status.py     # 连接状态资源
│   │   └── keys.py       # 键相关资源
│   └── tools/           # 工具实现
│       ├── __init__.py
│       ├── basic.py     # 基本 Redis 操作
│       ├── lists.py     # 列表操作
│       ├── hashes.py    # 哈希操作
│       ├── sets.py      # 集合操作
│       └── pubsub.py    # 发布/订阅操作
├── tests/              # 测试目录
│   └── __init__.py
├── README.md
└── pyproject.toml

要使用此服务器，您需要：

安装所需的依赖项：

[如果尚未安装] https://docs.astral.sh/uv/

uv venv

source .venv/bin/activate

uv sync

参考 .env.example 文件，通过添加适当的变量来配置您的 Redis 连接。

运行服务器：

python src/server.py

此服务器的功能

资源：

• redis://status - 当前连接状态
• redis://info - Redis 服务器信息
• redis://keys/{pattern} - 列出匹配模式的键

工具：

• 基本操作：
  • get_value - 获取一个值
  • set_value - 设置一个值，可选择过期时间
  • delete_key - 删除一个键
  • increment - 递增一个数值
• 列表操作：
  • list_push - 将值推送到列表
  • list_range - 获取列表值的范围
• 哈希操作：
  • hash_set - 设置哈希字段
  • hash_get - 获取哈希字段
• 集合操作：
  • set_add - 添加到集合
  • set_members - 获取集合成员
• 发布/订阅：
  • publish_message - 发布消息

每个工具都包含错误处理并返回有意义的响应。 如果连接丢失，服务器将自动重新连接到 Redis。

您可以使用 MCP Inspector 进行测试： mcp dev src/server.py

或者将其安装在 Claude Desktop 中： mcp install src/server.py

示例

用户：当前的 Redis 连接状态是什么？
LLM：让我为您检查 Redis 连接状态。

[正在读取资源 redis://status]

Redis 服务器当前已连接并在 localhost:6379 上运行，数据库为 0。

用户：您能将我的名字“Alice”存储在 Redis 中吗？
LLM：我将帮助您使用 set_value 工具将您的名字存储在 Redis 中。

[正在调用 set_value，key="name" value="Alice"]
成功设置键 'name'

我已经将您的名字“Alice”存储在 Redis 中，键为“name”。 您希望我通过检索来验证该值是否已正确存储吗？

用户：是的，请验证
LLM：我将使用 get_value 工具检索该值。

[正在调用 get_value，key="name"]
Alice

是的，我可以确认您的名字“Alice”已成功存储在 Redis 中，并且可以正确检索。 该值与我们存储的完全匹配。

此实现为通过 MCP 进行 Redis 集成提供了坚实的基础。 您可以根据您的特定用例，通过添加更多 Redis 命令来进一步扩展它。