io.github.daedalus/mcp-redis-server

MCP server that exposes Redis API to AI models

DatabasesPythonv0.1.0

mcp-redis-server

MCP server that exposes Redis API to AI models

PyPI Python Ruff

mcp-name: io.github.daedalus/mcp-redis-server

Install

pip install mcp-redis-server

Usage

from mcp_redis_server import mcp

# Run the server
mcp.run()

Or as a CLI tool:

mcp-redis-server

API

The server exposes the following tools:

Connection

  • redis_connect - Connect to Redis server
  • redis_disconnect - Disconnect from Redis server
  • redis_ping - Ping the Redis server

Strings

  • redis_get, redis_set, redis_mget, redis_mset, redis_del
  • redis_incr, redis_decr

Lists

  • redis_lpush, redis_rpush, redis_lrange, redis_llen

Sets

  • redis_sadd, redis_srem, redis_smembers, redis_sismember, redis_scard

Hashes

  • redis_hset, redis_hget, redis_hmset, redis_hmget, redis_hgetall
  • redis_hkeys, redis_hvals, redis_hdel, redis_hlen

Sorted Sets

  • redis_zadd, redis_zscore, redis_zrange, redis_zrevrange, redis_zcard

Keys

  • redis_exists, redis_expire, redis_ttl, redis_type, redis_scan

Server

  • redis_dbsize, redis_flushdb, redis_flushall, redis_info
  • redis_config_get, redis_config_set

Configuration

Environment variables:

  • REDIS_HOST - Redis host (default: localhost)
  • REDIS_PORT - Redis port (default: 6379)
  • REDIS_PASSWORD - Redis password (optional)
  • REDIS_DB - Redis database number (default: 0)
  • REDIS_SSL - Enable SSL (default: false)

Development

git clone https://github.com/daedalus/mcp-redis-server.git
cd mcp-redis-server
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

Usage

from mcp_redis import mcp

# Run the server
mcp.run()

Or as a CLI tool:

mcp-redis

API

The server exposes the following tools:

Connection

  • redis_connect - Connect to Redis server
  • redis_disconnect - Disconnect from Redis server
  • redis_ping - Ping the Redis server

Strings

  • redis_get, redis_set, redis_mget, redis_mset, redis_del
  • redis_incr, redis_decr

Lists

  • redis_lpush, redis_rpush, redis_lrange, redis_llen

Sets

  • redis_sadd, redis_srem, redis_smembers, redis_sismember, redis_scard

Hashes

  • redis_hset, redis_hget, redis_hmset, redis_hmget, redis_hgetall
  • redis_hkeys, redis_hvals, redis_hdel, redis_hlen

Sorted Sets

  • redis_zadd, redis_zscore, redis_zrange, redis_zrevrange, redis_zcard

Keys

  • redis_exists, redis_expire, redis_ttl, redis_type, redis_scan

Server

  • redis_dbsize, redis_flushdb, redis_flushall, redis_info
  • redis_config_get, redis_config_set

Configuration

Environment variables:

  • REDIS_HOST - Redis host (default: localhost)
  • REDIS_PORT - Redis port (default: 6379)
  • REDIS_PASSWORD - Redis password (optional)
  • REDIS_DB - Redis database number (default: 0)
  • REDIS_SSL - Enable SSL (default: false)

Development

git clone https://github.com/daedalus/mcp-redis.git
cd mcp-redis
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx mcp-redis-server

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-daedalus-mcp-redis-server": {
      "command": "uvx",
      "args": [
        "mcp-redis-server"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

mcp-redis-serverpypi

Compatible MCP Clients

io.github.daedalus/mcp-redis-server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More