🔥 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
Metadata
1 maintainer
Release files for wredis-mcp 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| wredis_mcp-0.1.3.tar.gz | 27.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| wredis_mcp-0.1.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 49.4 kB
Release files / wredis_mcp-0.1.3.tar.gz
| Download URL | wredis_mcp-0.1.3.tar.gz |
|---|---|
| Size | 27.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7282e543baa92d60668ebd3674f89c104c6f15fe67a2731d86c444bc9ef75eef
|
|
BLAKE2b-256 checksum How to use checksums |
e44f2deb23e80daf502c1e0d678485c85585fe883d7164afd95535b42f260fef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / wredis_mcp-0.1.3-py3-none-any.whl
| Download URL | wredis_mcp-0.1.3-py3-none-any.whl |
|---|---|
| Size | 22.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
290a69637a48ea612437237e14d387ca658cb6dad76a2a1f9b3d7965f12dbb0e
|
|
BLAKE2b-256 checksum How to use checksums |
fe817eb92a79443797a4278a31c07b61874ce864e3c67a8002bcfc7d5bc7d448
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Security for wredis-mcp 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
