Redis

Provides access to Redis data operations via MCP for easy integration with client applications.

typescript

6

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "farhankaz-redis-mcp": {
      "command": "npx",
      "args": [
        "redis-mcp",
        "--redis-host",
        "localhost",
        "--redis-port",
        "6379"
      ]
    }
  }
}

You can access and manipulate Redis data through a dedicated MCP (Model Context Protocol) server. This server exposes Redis operations as simple, tool-based actions you can invoke from your MCP client, making it easy to build integrations that read, write, and query Redis data without writing Redis commands directly.

How to use

Connect to the Redis MCP server from your MCP client and start issuing Redis operations as individual tools. You will call each tool by name (for example hmset, hget, get, set, zadd, zrange, etc.) and pass the required parameters as defined by each tool’s input. The server handles the underlying Redis interaction, returning results or error information that your client can process.

How to install

Prerequisites: you need Node.js and npm installed on your machine. You can verify installations with node -v and npm -v.

Install the Redis MCP server client tooling via Smithery. The provided command installs the Redis MCP server client and registers it for your MCP workflow.

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

Additional notes and configuration

To connect your MCP client to a running Redis instance, configure the Redis MCP server entry in your MCP client with the following stdio command. This runs the Redis MCP toolset locally using npx and passes the Redis host and port to the server.

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["redis-mcp", "--redis-host", "localhost", "--redis-port", "6379"]
    }
  }
}

Security and defaults

By default, the Redis MCP server connects to a Redis instance on localhost:6379. If you run Redis on a different host or port, update the --redis-host and --redis-port options accordingly. Ensure your MCP client limits access to trusted applications and, if needed, applies authentication to Redis separately.

Available tools

hmset

Set multiple hash fields to multiple values in a Redis hash key.

hget

Get the value of a single field from a Redis hash key.

hgetall

Get all fields and values from a Redis hash key.

scan

Scan Redis keys matching a specified pattern with optional count limit.

set

Set a string value for a key with optional NX and PX (expiry) options.

get

Get the string value of a key.

del

Delete a key from Redis.

zadd

Add one or more members to a sorted set with scores.

zrange

Return a range of members from a sorted set by index, with optional scores.

zrangebyscore

Return members from a sorted set with scores within a specified range, with optional scores.

zrem

Remove one or more members from a sorted set.

sadd

Add one or more members to a set.

smembers

Get all members of a set.