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.