io.github.daedalus/mcp-redis-server

Connect to a Redis server. Args: host: Redis server hostname or IP address. port: Redis server port number. password: Redis server password (optional). db: Redis database number (0-15). ssl: Enable SSL/TLS connection. Returns: Connection status message. Example: >>> redis_connect("localhost", 6379, None, 0, False) "Connected to Redis at localhost:6379 (db 0)"

Disconnect from the Redis server. Returns: Disconnection status message. Example: >>> redis_disconnect() "Disconnected from Redis"

Ping the Redis server. Returns: PONG response if connected. Example: >>> redis_ping() "PONG"

Get the value of a key. Args: key: The key to retrieve. Returns: The value at key, or None if key doesn't exist. Example: >>> redis_get("mykey") "myvalue"

Set the value of a key. Args: key: The key to set. value: The value to set. nx: Only set if key doesn't exist. xx: Only set if key already exists. ex: Set expiration in seconds. Returns: OK if successful, None if condition not met. Example: >>> redis_set("mykey", "myvalue", ex=3600) "OK"

Get the values of multiple keys. Args: keys: List of keys to retrieve. Returns: List of values (None for missing keys). Example: >>> redis_mget(["key1", "key2"]) ["value1", "value2"]

Set multiple key-value pairs. Args: items: Dictionary of key-value pairs to set. Returns: OK status. Example: >>> redis_mset({"key1": "value1", "key2": "value2"}) "OK"

Delete one or more keys. Args: keys: List of keys to delete. Returns: Number of keys deleted. Example: >>> redis_del(["key1", "key2"]) 2

Increment the value of a key. Args: key: The key to increment. amount: Amount to increment by (default: 1). Returns: New value after increment. Example: >>> redis_incr("counter") 1

Decrement the value of a key. Args: key: The key to decrement. amount: Amount to decrement by (default: 1). Returns: New value after decrement. Example: >>> redis_decr("counter") -1

Push values to the left of a list. Args: key: The list key. values: Values to push. Returns: Length of the list after push. Example: >>> redis_lpush("mylist", ["value1", "value2"]) 2

Push values to the right of a list. Args: key: The list key. values: Values to push. Returns: Length of the list after push. Example: >>> redis_rpush("mylist", ["value1", "value2"]) 2

Get a range of elements from a list. Args: key: The list key. start: Start index. stop: Stop index (-1 for all). Returns: List of elements in range. Example: >>> redis_lrange("mylist", 0, -1) ["value2", "value1"]

Get the length of a list. Args: key: The list key. Returns: Length of the list. Example: >>> redis_llen("mylist") 2

Add members to a set. Args: key: The set key. members: Members to add. Returns: Number of members added. Example: >>> redis_sadd("myset", ["member1", "member2"]) 2

Remove members from a set. Args: key: The set key. members: Members to remove. Returns: Number of members removed. Example: >>> redis_srem("myset", ["member1"]) 1

Get all members of a set. Args: key: The set key. Returns: List of all members. Example: >>> redis_smembers("myset") ["member1", "member2"]

Check if a member exists in a set. Args: key: The set key. member: Member to check. Returns: True if member exists. Example: >>> redis_sismember("myset", "member1") True

Get the size of a set. Args: key: The set key. Returns: Number of members in the set. Example: >>> redis_scard("myset") 2

Set a field in a hash. Args: key: The hash key. field: Field name. value: Field value. Returns: 1 if new field, 0 if updated. Example: >>> redis_hset("myhash", "field1", "value1") 1

Get a field from a hash. Args: key: The hash key. field: Field name. Returns: Field value or None. Example: >>> redis_hget("myhash", "field1") "value1"

Set multiple fields in a hash. Args: key: The hash key. items: Dictionary of field-value pairs. Returns: OK status. Example: >>> redis_hmset("myhash", {"field1": "value1", "field2": "value2"}) "OK"

Get multiple fields from a hash. Args: key: The hash key. fields: List of field names. Returns: List of field values. Example: >>> redis_hmget("myhash", ["field1", "field2"]) ["value1", "value2"]

Get all fields and values from a hash. Args: key: The hash key. Returns: Dictionary of all field-value pairs. Example: >>> redis_hgetall("myhash") {"field1": "value1", "field2": "value2"}

Get all field names from a hash. Args: key: The hash key. Returns: List of field names. Example: >>> redis_hkeys("myhash") ["field1", "field2"]

Get all field values from a hash. Args: key: The hash key. Returns: List of field values. Example: >>> redis_hvals("myhash") ["value1", "value2"]

Delete fields from a hash. Args: key: The hash key. fields: List of fields to delete. Returns: Number of fields deleted. Example: >>> redis_hdel("myhash", ["field1"]) 1

Get the number of fields in a hash. Args: key: The hash key. Returns: Number of fields. Example: >>> redis_hlen("myhash") 2

Add members with scores to a sorted set. Args: key: The sorted set key. members: Dictionary of member-score pairs. Returns: Number of members added. Example: >>> redis_zadd("mysortedset", {"member1": 1.0, "member2": 2.0}) 2

Get the score of a member in a sorted set. Args: key: The sorted set key. member: Member name. Returns: Member's score or None. Example: >>> redis_zscore("mysortedset", "member1") 1.0

Get a range of members from a sorted set. Args: key: The sorted set key. start: Start index. stop: Stop index (-1 for all). withscores: Include scores in output. Returns: List of members (or member-score pairs). Example: >>> redis_zrange("mysortedset", 0, -1, True) ["member1", 1.0]

Get a range of members from a sorted set in reverse order. Args: key: The sorted set key. start: Start index. stop: Stop index (-1 for all). withscores: Include scores in output. Returns: List of members in reverse order. Example: >>> redis_zrevrange("mysortedset", 0, -1, True) ["member2", 2.0]

Get the size of a sorted set. Args: key: The sorted set key. Returns: Number of members. Example: >>> redis_zcard("mysortedset") 2

Check if keys exist. Args: keys: List of keys to check. Returns: Number of keys that exist. Example: >>> redis_exists(["key1", "key2"]) 1

Set expiration time on a key. Args: key: The key to expire. seconds: Expiration time in seconds. Returns: True if timeout was set. Example: >>> redis_expire("mykey", 3600) True

Get the time to live for a key. Args: key: The key to check. Returns: Seconds until expiration (-1 if no expire, -2 if key doesn't exist). Example: >>> redis_ttl("mykey") 3599

Get the type of a key. Args: key: The key to check. Returns: Type string (string, list, set, zset, hash, none). Example: >>> redis_type("mykey") "string"

Scan keys matching a pattern. Args: cursor: Cursor position (0 to start). match: Pattern to match (e.g., "user:*"). count: Number of keys to return per call. Returns: Tuple of (next cursor, list of keys). Example: >>> redis_scan(0, "user:*", 100) (1234, ["user:1", "user:2"])

Get the number of keys in the current database. Returns: Number of keys. Example: >>> redis_dbsize() 42

Flush all keys in the current database. Returns: OK status. Example: >>> redis_flushdb() "OK"

Flush all keys in all databases. Returns: OK status. Example: >>> redis_flushall() "OK"

Get Redis server information. Args: section: Info section (default: all). Returns: Dictionary of server information. Example: >>> redis_info() {"redis_version": "7.0.0", ...}

Get Redis configuration. Args: pattern: Configuration pattern to match. Returns: Dictionary of configuration values. Example: >>> redis_config_get("maxmemory") {"maxmemory": "0"}

Set Redis configuration. Args: name: Configuration parameter name. value: Configuration value. Returns: OK status. Example: >>> redis_config_set("maxmemory", "256mb") "OK"