Custom Redis

Redis MCP服务器

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

特性

• 具有持久性的Redis服务器
• Redis操作的MCP服务器集成
• Docker和Docker Compose支持
• 全面的错误处理和记录
• 基于环境的配置
• Redis服务的健康检查

先决条件

• 码头工人
• Docker Compose

快速开始

1. 克隆存储库：

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

1. 启动服务：

docker-compose up -d

1. 检查日志：

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）

发展

地方发展

1. 创建虚拟环境：

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

1. 安装依赖项：

pip install -r requirements.txt

1. 运行服务器：

python src/server.py

Docker开发

1. 塑造形象：

docker-compose build

1. 运行服务：

docker-compose up

项目结构

.
├── src/
│   └── server.py      # Main server implementation
├── Dockerfile         # Docker configuration
├── docker-compose.yml # Docker Compose configuration
├── requirements.txt   # Python dependencies
├── .env              # Environment variables
└── README.md         # This file

错误处理

该应用程序包括全面的错误处理：

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

日志记录

该应用程序使用Python的日志模块，具有以下功能：

• 基于时间戳的日志条目
• 不同的日志级别（信息、警告、错误）
• 详细的错误消息
• 操作成功/失败记录

与Claude Desktop一起使用

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

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

此配置：

• 使用Docker运行Redis MCP服务器
• 使用主机的Redis实例连接到Redis
• 以交互模式运行（-i）
• 使用后移除容器（--rm）
• 将MCP服务器连接到Redis容器的同一网络

确保：

1. Redis正在docker compose Redis服务的容器中运行
2. Redis端口（6379）可访问
3. Docker正在您的系统上运行

许可证

MIT许可证