https://github.com/GongRzhe/REDIS-MCP-Server
A Redis Model Context Protocol (MCP) server implementation for interacting with Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.
https://github.com/GongRzhe/REDIS-MCP-Server
Last synced: 3 months ago
JSON representation
A Redis Model Context Protocol (MCP) server implementation for interacting with Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.
- Host: GitHub
- URL: https://github.com/GongRzhe/REDIS-MCP-Server
- Owner: GongRzhe
- Created: 2024-12-24T14:43:59.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-03-06T12:43:31.000Z (3 months ago)
- Last Synced: 2025-03-06T13:39:29.875Z (3 months ago)
- Language: JavaScript
- Homepage:
- Size: 5.13 MB
- Stars: 10
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - Redis - A Redis MCP server (pushed to https://github.com/modelcontextprotocol/servers/tree/main/src/redis) implementation for interacting with Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools. (Table of Contents / Databases)
- awesome-mcp-servers - Redis - A Redis MCP server (pushed to https://github.com/modelcontextprotocol/servers/tree/main/src/redis) implementation for interacting with Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools. (Table of Contents / Databases)
README
# Redis MCP Server (@gongrzhe/[email protected])
[](https://smithery.ai/server/@gongrzhe/server-redis-mcp)
A Redis Model Context Protocol (MCP) server implementation for interacting with Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.
## Update
62 Redis MCP tools in https://github.com/GongRzhe/REDIS-MCP-Server/tree/redis-plus
## Installation & Usage
### Installing via Smithery
To install Redis MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@gongrzhe/server-redis-mcp):
```bash
npx -y @smithery/cli install @gongrzhe/server-redis-mcp --client claude
```
### Installing Manually
```bash
# Using npx with specific version (recommended)
npx @gongrzhe/[email protected] redis://your-redis-host:port
# Example:
npx @gongrzhe/[email protected] redis://localhost:6379
```
Or install globally:
```bash
# Install specific version globally
npm install -g @gongrzhe/[email protected]
# Run after global installation
@gongrzhe/server-redis-mcp redis://your-redis-host:port
```
## Components
### Tools
- **set**
- Set a Redis key-value pair with optional expiration
- Input:
- `key` (string): Redis key
- `value` (string): Value to store
- `expireSeconds` (number, optional): Expiration time in seconds
- **get**
- Get value by key from Redis
- Input: `key` (string): Redis key to retrieve
- **delete**
- Delete one or more keys from Redis
- Input: `key` (string | string[]): Key or array of keys to delete
- **list**
- List Redis keys matching a pattern
- Input: `pattern` (string, optional): Pattern to match keys (default: *)
## Configuration
### Usage with Claude Desktop
To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"redis": {
"command": "npx",
"args": [
"@gongrzhe/[email protected]",
"redis://localhost:6379"
]
}
}
}
```
Alternatively, you can use the node command directly if you have the package installed:
```json
{
"mcpServers": {
"redis": {
"command": "node",
"args": [
"path/to/build/index.js",
"redis://10.1.210.223:6379"
]
}
}
}
```
### Docker Usage
When using Docker:
* For macOS, use `host.docker.internal` if the Redis server is running on the host network
* Redis URL can be specified as an argument, defaults to "redis://localhost:6379"
```json
{
"mcpServers": {
"redis": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"mcp/redis",
"redis://host.docker.internal:6379"
]
}
}
}
```
## Development
### Building from Source
1. Clone the repository
2. Install dependencies:
```bash
npm install
```
3. Build the project:
```bash
npm run build
```
### Docker Build
```bash
docker build -t mcp/redis .
```
## License
This MCP server is licensed under the ISC License. For more details, please see the LICENSE file in the project repository.