Redis MCP Server

What is Redis MCP Server about?

Redis MCP Server offers a set of MCP‑compatible tools that let large language models read from and write to a Redis database. It abstracts common Redis commands (set, get, delete, list) into simple JSON‑based tool definitions that can be invoked by LLM agents.

How to use Redis MCP Server?

1. Installation via npx (recommended)

   npx @gongrzhe/server-redis-mcp@1.0.0 redis://your-redis-host:port
   

   Example:

   npx @gongrzhe/server-redis-mcp@1.0.0 redis://localhost:6379
   

2. Global installation (optional)

   npm install -g @gongrzhe/server-redis-mcp@1.0.0
   @gongrzhe/server-redis-mcp redis://localhost:6379
   

3. Claude Desktop configuration – add to claude_desktop_config.json:

   {
     "mcpServers": {
       "redis": {
         "command": "npx",
         "args": [
           "@gongrzhe/server-redis-mcp@1.0.0",
           "redis://localhost:6379"
         ]
       }
     }
   }
   

4. Docker usage – run the pre‑built image:

   {
     "mcpServers": {
       "redis": {
         "command": "docker",
         "args": ["run", "-i", "--rm", "mcp/redis", "redis://host.docker.internal:6379"]
       }
     }
   }
   

Key features of Redis MCP Server

• Standard MCP tool interface – compatible with Claude Desktop, Smithery, and other MCP‑aware clients.
• Core Redis operations – set (with optional TTL), get, delete (single or multiple keys), list (pattern matching).
• Zero‑code deployment – run directly with npx or via Docker without building from source.
• Cross‑platform – works on macOS, Linux, Windows, and inside containers.
• Open source under ISC License – free to modify and extend.

Use cases of Redis MCP Server

• LLM‑driven caching – let an assistant store intermediate results in Redis for fast retrieval.
• Dynamic configuration – LLMs can update feature flags or settings stored in Redis in real time.
• Session management – store user session data that the model can read/write during a conversation.
• Data enrichment pipelines – fetch supplementary data from Redis while generating responses.
• Automation scripts – combine with other MCP servers to build end‑to‑end workflows.

FAQ

Q: Do I need a Redis server already running? A: Yes. Provide the Redis URL (e.g., redis://localhost:6379) when starting the server.

Q: Can I set a TTL on a key? A: The set tool accepts an optional expireSeconds parameter to define expiration time.

Q: How does the server handle multiple keys for deletion? A: The delete tool accepts either a single key string or an array of key strings.

Q: Is Docker required? A: No. Docker is optional for containerized deployments; npx works in any Node.js environment.

Q: What license governs this project? A: The project is licensed under the ISC License.

Redis MCP Server (@gongrzhe/server-redis-mcp@1.0.0)

A Redis Model Context Protocol (MCP) server implementation for interacting with Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.

Update

62 Redis MCP tools in https://github.com/GongRzhe/REDIS-MCP-Server/tree/redis-plus

Installation & Usage

Installing via Smithery

To install Redis MCP Server for Claude Desktop automatically via Smithery:

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

Installing Manually

# Using npx with specific version (recommended)
npx @gongrzhe/server-redis-mcp@1.0.0 redis://your-redis-host:port

# Example:
npx @gongrzhe/server-redis-mcp@1.0.0 redis://localhost:6379

Or install globally:

# Install specific version globally
npm install -g @gongrzhe/server-redis-mcp@1.0.0

# Run after global installation
@gongrzhe/server-redis-mcp redis://your-redis-host:port

Components

Tools

• set

  • Set a Redis key-value pair with optional expiration
  • Input:
    • key (string): Redis key
    • value (string): Value to store
    • expireSeconds (number, optional): Expiration time in seconds

• get

  • Get value by key from Redis
  • Input: key (string): Redis key to retrieve

• delete

  • Delete one or more keys from Redis
  • Input: key (string | string[]): Key or array of keys to delete

• list

  • List Redis keys matching a pattern
  • Input: pattern (string, optional): Pattern to match keys (default: *)

Configuration

Usage with Claude Desktop

To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-redis-mcp@1.0.0",
        "redis://localhost:6379"
      ]
    }
  }
}

Alternatively, you can use the node command directly if you have the package installed:

{
  "mcpServers": {
    "redis": {
      "command": "node",
      "args": [
        "path/to/build/index.js",
        "redis://10.1.210.223:6379"
      ]
    }
  }
}

Docker Usage

When using Docker:

• For macOS, use host.docker.internal if the Redis server is running on the host network
• Redis URL can be specified as an argument, defaults to "redis://localhost:6379"

{
  "mcpServers": {
    "redis": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/redis", 
        "redis://host.docker.internal:6379"
      ]
    }
  }
}

Development

Building from Source

1. Clone the repository
2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Docker Build

docker build -t mcp/redis .

License

This MCP server is licensed under the ISC License. For more details, please see the LICENSE file in the project repository.