Redis MCP Server

v1.0.0Databasesstable

A Redis MCP server (pushed to https://github.com/modelcontextprotocol/servers/tree/main/src/redis) implementation for interacting with Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized too

redismcpai-integration
Share:
31
Stars
0
Downloads
0
Weekly
0/5

What is Redis MCP Server?

Redis MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to redis mcp server (pushed to https://github.com/modelcontextprotocol/servers/tree/main/src/redis) implementation for interacting with redis databases. this server enables llms to interact with redis ke...

A Redis MCP server (pushed to https://github.com/modelcontextprotocol/servers/tree/main/src/redis) implementation for interacting with Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized too

This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Redis MCP server (pushed to https://github.com/modelcontex

Use Cases

Manage Redis databases
Key-value operations
Cache management
GongRzhe

Maintainer

LicenseMIT License
Languagejavascript
Versionv1.0.0
UpdatedApr 1, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y redis

Manual Installation

npx -y redis

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Redis MCP Server

Redis MCP Server enables LLMs to interact directly with Redis key-value stores through four standardized operations: set, get, delete, and list with wildcard pattern matching. It implements the Model Context Protocol over the @gongrzhe/server-redis-mcp package and connects to any Redis instance via a standard connection URL, making it straightforward to add persistent key-value storage, cache inspection, and data retrieval to AI workflows. Developers can use it to read and write application caches, session stores, or feature flags through natural language without writing Redis client code.

Prerequisites

  • Node.js 16 or higher installed
  • A running Redis instance (local or remote) accessible via a Redis URL
  • An MCP-compatible client such as Claude Desktop or Claude Code
  • npm or npx available on your PATH
1

Ensure Redis is running

Start a local Redis instance if you don't have one. The default port is 6379.

redis-server
2

Install via Smithery (recommended)

The easiest installation path uses the Smithery CLI to configure the server for Claude automatically.

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

Or configure manually in claude_desktop_config.json

Add the Redis MCP server to your MCP client configuration, passing your Redis URL as an argument.

4

Restart Claude Desktop

Quit and reopen Claude Desktop so it picks up the new server configuration and connects to Redis.

5

Verify the connection

Ask your assistant to set a test key and retrieve it. If Redis is reachable you should get the value back.

Redis MCP Server Examples

Client configuration

Add the Redis MCP server to claude_desktop_config.json. Replace the Redis URL with your actual Redis instance.

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["-y", "@gongrzhe/[email protected]", "redis://localhost:6379"]
    }
  }
}

Prompts to try

Use these prompts to interact with your Redis store through natural language.

- "Set a Redis key 'user:123:session' with value 'abc456' that expires in 3600 seconds"
- "Get the value of the Redis key 'user:123:session'"
- "List all Redis keys matching the pattern 'user:*'"
- "Delete the keys 'temp:cache:1' and 'temp:cache:2' from Redis"
- "Show me all keys in the Redis store that start with 'feature_flag:'"

Troubleshooting Redis MCP Server

Connection refused when trying to reach Redis at localhost:6379

Ensure Redis is running with 'redis-cli ping'. If it returns PONG, Redis is up. If not, start it with 'redis-server'. On macOS with Homebrew: 'brew services start redis'.

Docker-based Redis is unreachable from Claude Desktop on macOS

Use 'host.docker.internal' instead of 'localhost' in your Redis URL when Redis runs inside Docker: redis://host.docker.internal:6379

The list tool returns no keys even though keys exist in Redis

Provide a wildcard pattern to the list tool. Pass '*' to list all keys, or 'prefix:*' to list keys with a specific prefix. An empty pattern may not match any keys.

Frequently Asked Questions about Redis MCP Server

What is Redis MCP Server?

Redis MCP Server is a Model Context Protocol (MCP) server that redis mcp server (pushed to https://github.com/modelcontextprotocol/servers/tree/main/src/redis) implementation for interacting with redis databases. this server enables llms to interact with redis key-value stores through a set of standardized too It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Redis MCP Server?

Install via npm with the command: npx -y redis. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Redis MCP Server?

Redis MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Redis MCP Server free to use?

Yes, Redis MCP Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Databases MCP Servers

Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Redis MCP Server?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides