RE

Redis

Created 6 months ago

A Redis Model Context Protocol (MCP) server implementation for interacting with Redis databases.

development documentation public

What is Redis?

Redis database operations and caching microservice server with support for key-value operations, expiration management, and pattern-based key listing.

Documentation

Redis MCP Server

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
```\n\n### Installing Manually
```bash\n\n# Using npx with specific version (recommended)
npx @gongrzhe/[email protected] redis://your-redis-host:port\n\n# Example: npx @gongrzhe/[email protected] redis://localhost:6379

Or install globally:

npm install -g @gongrzhe/[email protected]\n\n# Run after global installation
@gongrzhe/server-redis-mcp redis://your-redis-host:port
```\n\n### Components## Tools
- **set** - Set a Redis key-value pair with optional expiration
- **get** - Get value by key from Redis
- **delete** - Delete one or more keys from Redis
- **list** - List Redis keys matching a pattern\n\n### 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`:
```json
{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": [
        "@gongrzhe/[email protected]",
        "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"
      ]
    }
  }
}
```\n\n### 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"
```json
{
  "mcpServers": {
    "redis": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/redis",
        "redis://host.docker.internal:6379"
      ]
    }
  }
}
```\n\n### Development## Building from Source
1. Clone the repository
2. Install dependencies:
```bash
npm install
  1. Build the project:
npm run build
```\n\n### Docker Build
```bash
docker build -t mcp/redis .
```\n\n## License
This MCP server is licensed under the ISC License. For more details, please see the LICENSE file in the project repository.

Server Config

{
  "mcpServers": {
    "redis-server": {
      "command": "npx",
      "args": [
        "redis"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: May 23, 2025
Updated At: Aug 07, 2025
Author: GongRzhe
Category: community
License: ISC License
Tags:
development documentation public