Redis MCP 服务器

铁匠徽章

提供对 Redis 数据库操作的访问的模型上下文协议 (MCP) 服务器。

项目结构

src/
├── interfaces/
│   └── types.ts           # Shared TypeScript interfaces and types
├── tools/
│   ├── base_tool.ts       # Abstract base class for Redis tools
│   ├── tool_registry.ts   # Registry managing all available Redis tools
│   ├── hmset_tool.ts      # HMSET Redis operation
│   ├── hget_tool.ts       # HGET Redis operation
│   ├── hgetall_tool.ts    # HGETALL Redis operation
│   ├── scan_tool.ts       # SCAN Redis operation
│   ├── set_tool.ts        # SET Redis operation
│   ├── get_tool.ts        # GET Redis operation
│   ├── del_tool.ts        # DEL Redis operation
│   ├── zadd_tool.ts       # ZADD Redis operation
│   ├── zrange_tool.ts     # ZRANGE Redis operation
│   ├── zrangebyscore_tool.ts # ZRANGEBYSCORE Redis operation
│   └── zrem_tool.ts       # ZREM Redis operation
└── redis_server.ts        # Main server implementation

Related MCP server: Redash MCP Server

可用工具

工具	类型	描述	输入模式
设定	哈希命令	将多个哈希字段设置为多个值	`key` ：字符串（哈希键） `fields` ：对象（要设置的字段值对）
获得	哈希命令	获取哈希字段的值	`key` ：字符串（哈希键） `field` ：字符串（要获取的字段）
赫盖塔尔	哈希命令	获取哈希中的所有字段和值	`key` ：字符串（哈希键）
扫描	键盘命令	扫描与模式匹配的 Redis 键	`pattern` ：字符串（要匹配的模式，例如“user:*”） `count` ：数字，可选（要返回的键数）
放	字符串命令	使用可选的 NX 和 PX 选项设置字符串值	`key` ：字符串（要设置的键） `value` ：字符串（要设置的值） `nx` ：布尔值，可选（仅当不存在时才设置） `px` ：数字，可选（以毫秒为单位的有效期）
得到	字符串命令	获取字符串值	`key` ：字符串（要获取的键）
删除	键盘命令	删除密钥	`key` ：字符串（要删除的键）
扎德	排序集命令	向排序集合中添加一个或多个成员	`key` ：字符串（排序集键） `members` ：具有`score`的对象数组：数字和`value` ：字符串
范围	排序集命令	按索引返回排序集合中的一系列成员	`key` ：字符串（排序集键） `start` ：数字（起始索引） `stop` ：数字（终止索引） `withScores` ：布尔值，可选（在输出中包含分数）
zrangebyscore	排序集命令	返回排序集中分数介于最小值和最大值之间的成员	`key` ：字符串（排序集键） `min` ：数字（最低分数） `max` ：数字（最高分数） `withScores` ：布尔值，可选（在输出中包含分数）
兹雷姆	排序集命令	从排序集中删除一个或多个成员	`key` ：字符串（排序集键） `members` ：字符串数组（要删除的成员）
萨德	设置命令	向集合中添加一个或多个成员	`key` ：字符串（设置键） `members` ：字符串数组（要添加到集合中的成员）
成员	设置命令	获取集合中的所有成员	`key` ：字符串（设置键）

用法

在您的 MCP 客户端（例如，Claude Desktop、Cline）中配置：

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["redis-mcp", "--redis-host", "localhost", "--redis-port", "6379"],
      "disabled": false
    }
  }
}

命令行参数

--redis-host ：Redis 服务器主机（默认值：localhost）
--redis-port ：Redis 服务器端口（默认值：6379）

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Redis 服务器：

npx -y @smithery/cli install redis-mcp --client claude

发展

要添加新的 Redis 工具：

在src/tools/扩展RedisTool
在src/interfaces/types.ts中定义工具的接口
在src/tools/tool_registry.ts中注册该工具

工具实现示例：

export class MyTool extends RedisTool {
  name = 'mytool';
  description = 'Description of what the tool does';
  inputSchema = {
    type: 'object',
    properties: {
      // Define input parameters
    },
    required: ['requiredParam']
  };

  validateArgs(args: unknown): args is MyToolArgs {
    // Implement argument validation
  }

  async execute(args: unknown, client: RedisClientType): Promise<ToolResponse> {
    // Implement tool logic
  }
}