MCP Directory

How to add Redis MCP Server to Windsurf

Official Redis server: natural-language access to keys, search, and data structures in Redis. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 700★ · stdio · apikey · official

Windsurf config for Redis MCP Server

uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0
{
  "mcpServers": {
    "redis-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "redis-mcp-server@latest",
        "redis-mcp-server",
        "--url",
        "redis://<user>:<password>@<host>:6379/0"
      ]
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Redis MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Redis MCP Server's tools become available to Cascade.

Before you start

  • Python 3.14+ and the uv package manager (uvx is used to run the published package)
  • A reachable Redis instance (local, Redis Cloud, or Azure Managed Redis) and its connection URL or host/port
  • Redis credentials if your instance requires auth — a password and/or ACL username; for Azure Managed Redis you can use EntraID/Managed Identity instead
  • For vector search / JSON tools, a Redis with the Query Engine and JSON modules (e.g. Redis Stack or Redis 8+)

What Redis MCP Server can do in Windsurf

string

Set/get string values with optional expiration

hash

Manage hash field-value pairs, including storing vector embeddings

list

Append to and pop from Redis lists

set

Add, remove, and list set members

sorted set

Score-based add/range operations for leaderboards and priority queues

streams

Add, read, and delete stream entries and manage consumer groups

JSON

Store, retrieve, and manipulate JSON documents (RedisJSON)

pub/sub

Publish messages and manage subscriptions, including pattern matching

Security

The Redis connection URL can include the password, so avoid embedding production credentials in plaintext config and prefer a dedicated ACL user. An agent with write access can flush or overwrite keys, so scope permissions carefully.

Redis MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Redis MCP Server config there under the "mcpServers" key and restart the client.

Is Redis MCP Server safe to use with Windsurf?

The Redis connection URL can include the password, so avoid embedding production credentials in plaintext config and prefer a dedicated ACL user. An agent with write access can flush or overwrite keys, so scope permissions carefully.

How does it authenticate to Redis?

Pass a redis:// or rediss:// URL with embedded credentials, or set REDIS_USERNAME/REDIS_PWD. It supports Redis ACL users, TLS with certificate verification, and EntraID/Azure AD (Service Principal, Managed Identity, or Default Azure Credential) for Azure Managed Redis.

Do I need Redis Stack for vector search and JSON?

Yes for those features. The JSON and query-engine (vector index/search) tools require the RedisJSON and Query Engine modules, available in Redis Stack or Redis 8+. Core data-type tools work on any standard Redis.

What transport does it use?

stdio. The server runs over standard input/output for local MCP clients; HTTP streaming transport is noted as planned for the future.

View repo Full Redis MCP Server page