Redis CRUD MCP 服务器

这是一个 Model Context Protocol (MCP) 服务器，提供完整的 Redis 数据库 CRUD 操作工具。

功能特性

支持 Redis 的主要数据类型：

字符串 (Strings)

• redis_set: 在 Redis 中设置字符串键值对
• redis_get: 获取 Redis 中字符串键的值

列表 (Lists)

• redis_lpush: 从列表左侧推入元素
• redis_rpush: 从列表右侧推入元素
• redis_lpop: 从列表左侧弹出元素
• redis_rpop: 从列表右侧弹出元素
• redis_lrange: 获取列表指定范围的元素
• redis_llen: 获取列表长度

集合 (Sets)

• redis_sadd: 向集合添加成员
• redis_srem: 从集合移除成员
• redis_smembers: 获取集合的所有成员
• redis_sismember: 检查成员是否在集合中

哈希 (Hashes)

• redis_hset: 设置哈希字段的值
• redis_hget: 获取哈希字段的值
• redis_hgetall: 获取哈希的所有字段和值
• redis_hdel: 删除哈希字段

有序集合 (Sorted Sets)

• redis_zadd: 向有序集合添加成员
• redis_zrem: 从有序集合移除成员
• redis_zrange: 获取有序集合指定分数范围的成员

通用操作

• redis_del: 删除 Redis 中的键
• redis_exists: 检查 Redis 中键是否存在

安装

1. 安装依赖：

npm install

2. 构建项目：

npm run build

配置

服务器通过环境变量连接到 Redis 数据库：

• REDIS_HOST: Redis 服务器主机地址 (默认: 127.0.0.1)
• REDIS_PORT: Redis 服务器端口 (默认: 6379)
• REDIS_PASSWORD: Redis 密码 (必需)

启动服务器

npm start

测试

运行测试脚本验证功能：

node test.js

在 Cline 中使用

要将此服务器添加到 Cline MCP 配置中：

1. 复制项目中的 cline_mcp_settings.example.json 文件
2. 编辑其中的配置信息：
   • 将 "path/to/your/redis-crud-server/build/index.js" 替换为实际的构建文件路径
   • 设置正确的 Redis 连接参数
3. 将配置添加到您的 cline_mcp_settings.json 文件中

配置位置:

• Windows: %APPDATA%\\Code\\User\\globalStorage\\saoudrizwan.claude-dev\\settings\\cline_mcp_settings.json
• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

环境变量配置

必需的环境变量:

• REDIS_HOST: Redis 服务器主机地址 (默认: 127.0.0.1)
• REDIS_PORT: Redis 服务器端口 (默认: 6379)
• REDIS_PASSWORD: Redis 密码 (必需)

配置示例

{
  "mcpServers": {
    "redis-crud-server": {
      "autoApprove": [
        "redis_set",
        "redis_get",
        "redis_del",
        "redis_exists",
        "redis_lpush",
        "redis_rpush",
        "redis_lpop",
        "redis_rpop",
        "redis_lrange",
        "redis_llen",
        "redis_sadd",
        "redis_srem",
        "redis_smembers",
        "redis_sismember",
        "redis_hset",
        "redis_hget",
        "redis_hgetall",
        "redis_hdel",
        "redis_zadd",
        "redis_zrem",
        "redis_zrange"
      ],
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": [
        "/path/to/your/project/redis-crud-server/build/index.js"
      ],
      "env": {
        "REDIS_HOST": "127.0.0.1",
        "REDIS_PORT": "6379",
        "REDIS_PASSWORD": "your_actual_redis_password"
      }
    }
  }
}

使用说明

配置完成后，重启 VS Code，Redis CRUD 工具将在 Cline 中可用。

开发

• 使用 TypeScript 编写
• 支持热重载开发：npm run watch
• 构建输出到 build/ 目录

许可证

MIT