redis-mcp-server

Redis MCP Server

A Redis Management and Control Protocol (MCP) server implementation using Spring Boot and Spring AI.

Description

This project implements a Redis MCP server that provides a set of tools for Redis operations. It uses spring-ai-mcp-server-webmvc-spring-boot-starter to implement MCP Server-Sent Events (SSE) functionality.

Prerequisites

• JDK 17 or higher
• Maven 3.6 or higher
• Redis server

Components

• Spring Boot
• Spring AI
• Spring Data Redis
• Lettuce Redis Client
• Jackson
• spring-ai-mcp-server-webmvc-spring-boot-starter

Features

• Redis key-value operations (set, get, delete)
• Pattern-based key listing
• Optional key expiration time
• SSE-based MCP implementation

Configuration

Server Configuration

The Redis connection can be configured using the redis.url system property. Default value is redis://localhost:6379.

Example:

java -Dredis.url=redis://your-redis-host:6379 -jar your-app.jar

Cursor Tool Configuration

To use this MCP server in Cursor, add the following configuration to your Cursor settings:

{
  "redis-mcp-server": {
    "url": "http://localhost:8080/sse",
    "enabled": true
  }
}

Building

mvn clean package

Running

java -jar target/redis-mcp-server-{version}.jar

API Endpoints

The server exposes the following MCP tools:

• set: Set a Redis key-value pair with optional expiration time
• get: Get value from Redis by key
• delete: Delete one or multiple keys from Redis
• list: List Redis keys matching a pattern

License

This project is licensed under the MIT License.