🚀 Valkey GLIDE MCP Server

The complete Model Context Protocol (MCP) server for Valkey GLIDE - providing comprehensive migration assistance, intelligent code generation, and complete API coverage for AI assistants.

✨ Features at a Glance

🎯 Complete API Coverage: 673 methods across all GLIDE-supported commands
🔄 Smart Migration: 100% success rate on 65+ tested migration patterns
⚡ Comprehensive Commands: Support for 296 commands supported by GLIDE
🏗️ Intelligent Generation: Context-aware code templates for all use cases
✅ Runtime Validated: All migrations tested against live Valkey instances
🔧 Production Ready: Based on actual GitHub repositories, not toy examples

🎯 What This Tool Does

This MCP server transforms AI assistants (Claude, Continue, Cline, Zed, etc.) into Valkey GLIDE experts by providing:

• 🔄 Universal Migration: Seamlessly convert any ioredis/node-redis code to GLIDE
• 🏗️ Smart Code Generation: Generate production-ready GLIDE code for any pattern
• 📚 Complete API Knowledge: Instant access to all 673 GLIDE methods and their usage
• 🎯 Pattern Recognition: Handle complex real-world scenarios (locks, rate limiting, pub/sub, transactions)
• ✅ Validation Tools: Verify code correctness and API compliance

🚀 Quick Start

One-Command Installation

# Install globally (recommended)
npm install -g valkey-glidejs-mcp

# Or use with npx (no installation)
npx valkey-glidejs-mcp

🔧 Setup for AI Assistants

claude mcp add --scope user valkey-glidejs-mcp valkey-glidejs-mcp

{
  "mcpServers": {
    "valkey-glide": {
      "command": "npx",
      "args": ["valkey-glidejs-mcp"]
    }
  }
}

💬 What You Can Ask

Once installed, your AI assistant becomes a Valkey GLIDE expert. Try these prompts:

🔄 Migration Assistance

"Migrate this ioredis code to GLIDE"
"Convert my node-redis app to use GLIDE"
"How do I migrate Redis pipelines to GLIDE batch operations?"

🏗️ Code Generation

"Create a GLIDE client for my app"
"Generate a distributed lock with GLIDE"
"Build a rate limiter using GLIDE and streams"
"Show me pub/sub patterns with GLIDE"

📚 API Documentation

"What GLIDE methods work with sorted sets?"
"How do I use GLIDE for geospatial operations?"
"Show me all available GLIDE string commands"

🎯 Advanced Patterns

"Implement a Redis cache-aside pattern with GLIDE"
"Create a job queue using GLIDE streams"
"Build idempotency with GLIDE transactions"

🛠️ Comprehensive Tool Suite

🔄 Universal Migration Engine

Complete Client Support: Handles both ioredis and node-redis with 65+ tested migration patterns

• ✅ URL Parsing: Automatic redis:// and rediss:// URL handling with TLS/auth extraction
• ✅ Smart Config Mapping: Intelligent conversion of connection options and retry strategies
• ✅ Batch Processing: Converts deprecated pipelines to GLIDE Batch with non-atomic execution
• ✅ Transaction Translation: Converts multi/exec to GLIDE Batch with atomic guarantees
• ✅ Script Migration: Transforms redis.eval() to GLIDE Script objects with proper scoping
• ✅ Pub/Sub Conversion: Complete event-driven pattern migration with examples
• ✅ Native Operations: Direct mapping to GLIDE's native blocking and atomic operations

🏗️ Intelligent Code Generation

Production-Ready Templates for every Valkey use case:

• Client Setup: Standalone, cluster, and advanced configurations
• Data Structures: Strings, hashes, lists, sets, sorted sets, streams, geo, bitmaps, HyperLogLog, JSON
• Advanced Patterns: Distributed locks, rate limiters, caching, pub/sub, transactions
• Real-World Scenarios: Session management, job queues, idempotency, circuit breakers

📚 Complete API Coverage

673 Methods with comprehensive documentation:

• 🔍 Smart Search: Find any method by name, category, or functionality
• 📋 Category Browsing: Organized by command families (strings, lists, sets, etc.)
• 📖 Detailed Docs: Usage examples, parameters, and return types for every method
• ✅ Validation Tools: Verify API usage and code correctness

🏃‍♂️ Quick Example

import { GlideClient } from "@valkey/valkey-glide";

// Create client with smart configuration
const client = await GlideClient.createClient({
  addresses: [{ host: "localhost", port: 6379 }],
  // GLIDE automatically handles retries and optimization
});

// All operations are fully typed and validated
await client.set("user:1001", JSON.stringify({ name: "Alice", age: 30 }));
const userData = await client.get("user:1001");

// Advanced operations work seamlessly
await client.zadd("leaderboard", { alice: 95, bob: 87, charlie: 92 });
const topPlayers = await client.zrevrange("leaderboard", 0, 2);

// Clean shutdown
client.close();

📊 Performance & Quality Metrics

🎯 Key Differences from ioredis/node-redis

💻 Development & Contributing

Build from Source

# Clone and setup
git clone https://github.com/avifenesh/valkey-glidejs-mcp.git
cd valkey-glidejs-mcp
npm install
npm run build

# Run comprehensive tests (65+ migration patterns)
npm test

# Validate API mappings
npm run validate:glide

# Ingest latest command documentation
npm run ingest:commands

Contributing

We welcome contributions! See CONTRIBUTING.md for:

• 📝 Commit message guidelines
• 🔄 Development workflow
• 🧪 Testing requirements
• 📚 Documentation standards

📄 License & Links

License: MIT

Resources:

• 📦 NPM Package
• 📖 Valkey GLIDE Documentation
• 🔗 Model Context Protocol
• 🐛 Issues & Feedback