🔥 wredis-mcp
Transform your AI Agents into expert WRedis Architects.
wredis-mcp is a professional Model Context Protocol (MCP) server that bridges the gap between AI Agents (Claude, Gemini, OpenCode) and WRedis. It empowers agents to search, design, and deploy high-performance Redis-backed services following strict industry-standard patterns.
✨ Key Features
- 🔍 Expert Pattern Catalog: Query production-ready patterns across all WRedis data structures (Hash, Queue, Stream, Pub/Sub, SortedSet, Geo, Bitmap, HyperLogLog, Pipeline, Transaction, Cache, HA).
- 🏗️ Strict Architecture Enforcement: Guides AI to output clean code using mandatory
config/,cache/,repositories/, andmain.pyfolder structures. - 📘 Architect's Manual: Built-in expertise for Monolith-to-Redis refactoring, TTL management, key naming, and atomicity patterns.
- 💻 Unified CLI: Manage your MCP service with simple commands:
run,start,stop, andconfig. - 🛡️ Privacy First: 100% local execution via
stdioorSSE.
🚀 Quick Start
1. Installation
Clone the repository and run the automated installer, or install via pip:
pip install -e .
2. Integration
Get your agent-specific configuration block and installation commands by running:
wredis-mcp config
The CLI will dynamically detect your Python environment and provide exact copy-paste commands for Gemini CLI (e.g. gemini mcp add ...) and JSON blocks for Claude Desktop.
🛠️ CLI Usage
| Command | Description |
|---|---|
wredis-mcp run |
Start the server in stdio mode (default for agents). |
wredis-mcp start |
Start as an SSE server in the background. |
wredis-mcp stop |
Stop the background server. |
wredis-mcp config |
Generate and save JSON config to .agents/wredis-mcp.json. |
wredis-mcp config --print |
Show JSON configuration in stdout (no file creation). |
wredis-mcp help |
Show available tools and commands. |
🛠️ MCP Tools
| Tool | Description |
|---|---|
get_wredis_architect_blueprints |
Copy-pasteable expert code for caching, queues, streams, sessions and atomic transactions. |
search_wredis_pattern |
Search the official/community catalog for production-ready Redis patterns. |
deploy_wredis_scaffolding |
Deploy a professional WRedis project structure (config/, cache/, repositories/, main.py). |
get_wredis_architect_manual |
Expert manual for building high-performance Redis-backed systems. |
📂 Project Structure
src/wredis_mcp/: Core server logic and tools.src/wredis_mcp/catalog.py: Pattern catalog synchronization with local fallbacks.src/wredis_mcp/templates.py: Professional boilerplate definitions.examples/: Sample implementations and use cases.
📄 License
MIT License - Crafted with ❤️ by William Rodriguez (wisrovi).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file wredis_mcp-0.1.1.tar.gz.
File metadata
- Download URL: wredis_mcp-0.1.1.tar.gz
- Upload date:
- Size: 26.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d003411bb3fc6f2ddf90eb9f0880a43615e5198675ad97e2b73f3818c6f66d7a
|
|
| MD5 |
4ca0b9016fa217ab472fea37f59887b5
|
|
| BLAKE2b-256 |
c935d6d3c1a2c953ddb870cf9ad5b0b7b8edc98785c68d1604eb935b5be38afa
|
File details
Details for the file wredis_mcp-0.1.1-py3-none-any.whl.
File metadata
- Download URL: wredis_mcp-0.1.1-py3-none-any.whl
- Upload date:
- Size: 21.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fc6090891fa3c3fe55996c7e3e9af2562ce3f1ab0f0bc3a2835a3eaed5c616c8
|
|
| MD5 |
dafd272a04927d027b9857ea4ae9a7ea
|
|
| BLAKE2b-256 |
5c7e41e05342c4986a907a1cab22be6508dbea3e998c1666e1aa54c77dd67b15
|
