Redis MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides access to Redis database operations through a Model Context Protocol (MCP) server. Includes tools for various Redis commands such as HMSET, HGET, HGETALL, SCAN, SET, GET, DEL, ZADD, ZRANGE, ZRANGEBYSCORE, ZREM, SADD, and SMEMBERS.

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

可用工具

工具类型描述输入模式
设定哈希命令将多个哈希字段设置为多个值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 工具:

  1. src/tools/扩展RedisTool
  2. src/interfaces/types.ts中定义工具的接口
  3. 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 } }

执照

麻省理工学院:https: //opensource.org/license/mit

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

使用户能够使用模型上下文协议 (MCP) 工具执行 Redis 数据库操作,从而通过设置、获取和扫描哈希字段等命令实现高效的数据管理。

  1. Project Structure
    1. Available Tools
      1. Usage
        1. Command Line Arguments
          1. Installing via Smithery
        2. Development
          1. License
            ID: cbn7lsbp7h