MCP 服务器

Redis MCP Server

Redis MCP 服务器 - 使用 Docker 的 Python 实现

cbuitragoh

开发者工具

访问服务器

README

Redis MCP 服务器

一个专业的 Redis 服务器实现，集成了 MCP（模型控制协议），并使用 Docker 容器化。

特性

具有持久性的 Redis 服务器
用于 Redis 操作的 MCP 服务器集成
Docker 和 Docker Compose 支持
完善的错误处理和日志记录
基于环境变量的配置
Redis 服务的健康检查

前提条件

Docker
Docker Compose

快速开始

克隆仓库：

git clone https://github.com/cbuitragoh/customRedis.git
cd customredis

启动服务：

docker-compose up -d

查看日志：

docker-compose logs -f

可用的 Redis 操作

MCP 服务器提供以下 Redis 操作：

set_redis_key(key: str, value: str): 设置键值对
get_redis_key(key: str): 通过键检索值
delete_redis_key(key: str): 删除键
list_redis_keys(pattern: str = '*'): 列出所有匹配模式的键

配置

可以通过环境变量配置应用程序：

REDIS_HOST: Redis 服务器主机 (默认: redis)
REDIS_PORT: Redis 服务器端口 (默认: 6379)
REDIS_DB: Redis 数据库编号 (默认: 0)
LOG_LEVEL: 日志级别 (默认: INFO)

开发

本地开发

创建一个虚拟环境：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上: .venv\Scripts\activate

安装依赖：

pip install -r requirements.txt

运行服务器：

python src/server.py

Docker 开发

构建镜像：

docker-compose build

运行服务：

docker-compose up

项目结构

.
├── src/
│   └── server.py      # 主要服务器实现
├── Dockerfile         # Docker 配置
├── docker-compose.yml # Docker Compose 配置
├── requirements.txt   # Python 依赖
├── .env              # 环境变量
└── README.md         # 本文件

错误处理

应用程序包含完善的错误处理：

连接错误
Redis 操作错误
服务器启动/关闭错误
键盘中断时的优雅关闭

日志记录

应用程序使用 Python 的 logging 模块，具有以下特性：

基于时间戳的日志条目
不同的日志级别 (INFO, WARNING, ERROR)
详细的错误消息
操作成功/失败日志记录

与 Claude Desktop 一起使用

要将此 Redis MCP 服务器与 Claude Desktop 一起使用，请将以下配置添加到您的 Claude Desktop 设置：

{
  "mcpServers": {
    "redis": {
            "command": "docker",
            "args": [
                "run", 
                "-i",
                "--rm",
                "--network",
                "customredis_redis-network",
                "customredis-mcp-server"]
    }
  }
}