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

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

By GongRzhe GitHub

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.

Overview

What is Redis MCP Server?

Redis MCP Server is a microservice designed for performing Redis database operations and caching, enabling large language models (LLMs) to interact effectively with Redis key-value stores.

How to use Redis MCP Server?

Users can install the server using Smithery or manually via npm, and configure it to interface with Redis databases by providing the relevant connection strings.

Key features of Redis MCP Server?

  • Protocol for integrating LLMs with Redis databases
  • Operations for setting, getting, deleting, and listing keys in Redis
  • Flexible installation options including using Docker

Use cases of Redis MCP Server?

  1. Caching data for AI applications to enhance performance.
  2. Managing key-value pairs for dynamic content storage.
  3. Interfacing with Redis for rapid data retrieval in LLM-trained environments.

FAQ from Redis MCP Server?

  • Can this server handle multiple Redis connections?

Yes, it can be configured to handle multiple connections through custom settings.

  • Is Redis MCP Server open-source?

Yes, it is licensed under the ISC License and is available on GitHub.

  • What platforms does it support?

It supports any platform that can run Node.js, including both local installations and Docker environments.

Content

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

smithery badge

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.

No tools information available.
No content found.