Amazon ElastiCache/MemoryDB for Valkey — Claude Code MCP server
Amazon ElastiCache/MemoryDB for Valkey is an MCP server for Claude Code with 12 Valkey tools for search indices, JSON paths and tiered command execution.
Apache-2.0 ★ 9,939 updated 2026-10-23
Open on GitHubWhat Amazon ElastiCache/MemoryDB for Valkey does
Twelve tools, grouped into three sets. Index work runs through four of them: one builds, drops and lists indices from a schema you describe, another loads documents and can generate embeddings on the way in, a third handles semantic, keyword, hybrid and similar-item lookups, and the last assembles aggregation pipelines with grouping, sorting and filters.
JSON keys get five tools for reading and writing a value at a path, appending to arrays, popping elements and trimming ranges. The remaining three execute raw commands and are ranked by risk: reads always pass, writes reject destructive commands and switch off under --readonly, admin calls stay disabled until VALKEY_ADMIN_ENABLED=true is set and confirm=True is passed.
Startup is uvx awslabs.valkey-mcp-server@latest once uv and Python 3.10 are installed, and the datastore needs the Search and JSON modules — both ship in the valkey/valkey-bundle image. Embeddings go to Bedrock by default, so with no AWS credentials semantic calls die on NoCredentialsError; set EMBEDDING_PROVIDER to Ollama or supply OPENAI_API_KEY for OpenAI.
What it helps with
- Build a search index over product fields without writing raw search commands
- Load documents into an index with embeddings generated for you
- Patch one field inside a JSON document without rewriting the key
- Aggregate average values grouped by category
- Give an agent read access while destructive commands stay blocked
Example prompts for the agent
- Create a
productsindex in Valkey withtitleas TEXT,categoryas TAG andpriceas NUMERIC. - Load the product documents into the
productsindex. - What is the average price per category in
products?
How to install Amazon ElastiCache/MemoryDB for Valkey
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Amazon ElastiCache/MemoryDB for Valkey
How to install Amazon ElastiCache/MemoryDB for Valkey in Claude Code?
Add an mcpServers entry to your MCP settings file with uvx as the command, awslabs.valkey-mcp-server@latest as the argument, and VALKEY_HOST plus VALKEY_PORT in env. Install uv first, then run uv python install 3.10.
What does this MCP server do?
It exposes 12 Valkey tools to an agent: four for search indices and aggregations, five for JSON values at paths, and three for commands with guardrails against destructive calls.
Which embedding provider needs which credentials?
Bedrock is the default and expects AWS credentials. OpenAI reads OPENAI_API_KEY, and Ollama only needs a running local instance.