Redis

REDIS-MCP-Server: A Comprehensive Summary

What is REDIS-MCP-Server?

REDIS-MCP-Server is a Redis Model Context Protocol (MCP) server designed to facilitate interaction between Large Language Models (LLMs) and Redis databases. It provides a standardized set of tools that allow LLMs to perform operations on Redis key-value stores, making it easier to integrate Redis into AI-powered applications.

How to use REDIS-MCP-Server?

REDIS-MCP-Server can be installed and used in several ways:

Installation via Smithery (Recommended for Claude Desktop)

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

Manual Installation

Using npx:

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

Global Installation:

npm install -g @gongrzhe/server-redis-mcp@1.0.0
@gongrzhe/server-redis-mcp redis://your-redis-host:port

Configuration with Claude Desktop

Add the following to your claude_desktop_config.json:

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

Docker Usage

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

Key Features of REDIS-MCP-Server

• Standardized Tools: Provides a consistent interface for LLMs to interact with Redis.
• Key-Value Operations: Supports basic Redis operations like set, get, and delete.
• Expiration Management: Allows setting expiration times for keys.
• Pattern-based Key Listing: Enables listing Redis keys based on patterns.
• Easy Integration: Designed for straightforward integration with LLMs and platforms like Claude Desktop.
• Docker Support: Can be easily deployed using Docker.

Use Cases of REDIS-MCP-Server

• LLM Memory and Context: LLMs can use Redis to store and retrieve conversational context or other dynamic data.
• Caching for LLM Applications: Implement caching mechanisms for frequently accessed data to improve LLM application performance.
• Session Management: Manage user sessions in applications powered by LLMs.
• Real-time Data Storage: Store and access real-time data for LLM-driven analytics or decision-making.

FAQ about REDIS-MCP-Server

Q: What is MCP? A: MCP stands for Model Context Protocol, a protocol that enables LLMs to interact with external services and data sources through standardized tools.

Q: Can I use this with other LLMs besides Claude Desktop? A: While specifically mentioned for Claude Desktop, the underlying MCP concept and the server

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.