prajwalnayak7/mcp-server-redis

The structure is as follows:
mcp-server-redis/
├── src/
│ ├── init.py
│ ├── main.py # Main entry point
│ ├── config.py # Configuration
│ ├── connection.py # Redis connection management
│ ├── resources/ # Resource implementations
│ │ ├── init.py
│ │ ├── status.py # Connection status resources
│ │ └── keys.py # Key-related resources
│ └── tools/ # Tool implementations
│ ├── init.py
│ ├── basic.py # Basic Redis operations
│ ├── lists.py # List operations
│ ├── hashes.py # Hash operations
│ ├── sets.py # Set operations
│ └── pubsub.py # Pub/Sub operations
├── tests/ # Test directory
│ └── init.py
├── README.md
└── pyproject.toml
To use this server, you'll need to:
Install the required dependencies:
[If not already installed] https://docs.astral.sh/uv/
uv venv
source .venv/bin/activate
uv sync
Refer to the .env.example file to configure your Redis connection by adding the appropriate variables.
Run the server:
python src/server.py
## Capabilities of this server
Resources:
redis://status - Current connection status
redis://info - Redis server information
redis://keys/{pattern} - List keys matching a pattern
Tools:
Basic operations:
getvalue - Get a value
setvalue - Set a value with optional expiry
deletekey - Delete a key
increment - Increment a numeric value
List operations:
listpush - Push values to a list
listrange - Get range of list values
Hash operations:
hashset - Set hash fields
hashget - Get hash fields
Set operations:
setadd - Add to a set
setmembers - Get set members
Pub/Sub:
publishmessage - Publish a message
Each tool includes error handling and returns meaningful responses. The server will automatically reconnect to Redis if the connection is lost.
You can test it with the MCP Inspector:
mcp dev src/server.py
Or install it in Claude Desktop:
mcp install src/server.py
## Example
User: What's the current Redis connection status?
LLM: Let me check the Redis connection status for you.
[Reading resource redis://status]
The Redis server is currently connected and running on localhost:6379, database 0.
User: Can you store my name "Alice" in Redis?
LLM: I'll help you store your name in Redis using the setvalue tool.
[Calling setvalue with key="name" value="Alice"]
Successfully set key 'name'
I've stored your name "Alice" in Redis under the key "name". Would you like me to verify the value was stored correctly by retrieving it?