Metadata-Version: 2.4
Name: mcp-redis-server
Version: 0.1.0
Summary: MCP server that exposes Redis API to AI models
Project-URL: Homepage, https://github.com/daedalus/mcp-redis-server
Project-URL: Repository, https://github.com/daedalus/mcp-redis-server
Project-URL: Issues, https://github.com/daedalus/mcp-redis-server/issues
Author-email: Dario Clavijo <clavijodario@gmail.com>
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: fastmcp
Requires-Dist: redis>=5.0.0
Provides-Extra: all
Requires-Dist: hatch; extra == 'all'
Requires-Dist: hypothesis; extra == 'all'
Requires-Dist: mypy; extra == 'all'
Requires-Dist: pip-api; extra == 'all'
Requires-Dist: pytest; extra == 'all'
Requires-Dist: pytest-asyncio; extra == 'all'
Requires-Dist: pytest-cov; extra == 'all'
Requires-Dist: pytest-mock; extra == 'all'
Requires-Dist: ruff; extra == 'all'
Provides-Extra: dev
Requires-Dist: hatch; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pip-api; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: lint
Requires-Dist: mypy; extra == 'lint'
Requires-Dist: ruff; extra == 'lint'
Provides-Extra: test
Requires-Dist: hypothesis; extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-asyncio; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: pytest-mock; extra == 'test'
Description-Content-Type: text/markdown

# mcp-redis-server

> MCP server that exposes Redis API to AI models

[![PyPI](https://img.shields.io/pypi/v/mcp-redis-server.svg)](https://pypi.org/project/mcp-redis-server/)
[![Python](https://img.shields.io/pypi/pyversions/mcp-redis-server.svg)](https://pypi.org/project/mcp-redis-server/)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

mcp-name: io.github.daedalus/mcp-redis-server

## Install

```bash
pip install mcp-redis-server
```

## Usage

```python
from mcp_redis_server import mcp

# Run the server
mcp.run()
```

Or as a CLI tool:

```bash
mcp-redis-server
```

## API

The server exposes the following tools:

### Connection
- `redis_connect` - Connect to Redis server
- `redis_disconnect` - Disconnect from Redis server
- `redis_ping` - Ping the Redis server

### Strings
- `redis_get`, `redis_set`, `redis_mget`, `redis_mset`, `redis_del`
- `redis_incr`, `redis_decr`

### Lists
- `redis_lpush`, `redis_rpush`, `redis_lrange`, `redis_llen`

### Sets
- `redis_sadd`, `redis_srem`, `redis_smembers`, `redis_sismember`, `redis_scard`

### Hashes
- `redis_hset`, `redis_hget`, `redis_hmset`, `redis_hmget`, `redis_hgetall`
- `redis_hkeys`, `redis_hvals`, `redis_hdel`, `redis_hlen`

### Sorted Sets
- `redis_zadd`, `redis_zscore`, `redis_zrange`, `redis_zrevrange`, `redis_zcard`

### Keys
- `redis_exists`, `redis_expire`, `redis_ttl`, `redis_type`, `redis_scan`

### Server
- `redis_dbsize`, `redis_flushdb`, `redis_flushall`, `redis_info`
- `redis_config_get`, `redis_config_set`

## Configuration

Environment variables:
- `REDIS_HOST` - Redis host (default: localhost)
- `REDIS_PORT` - Redis port (default: 6379)
- `REDIS_PASSWORD` - Redis password (optional)
- `REDIS_DB` - Redis database number (default: 0)
- `REDIS_SSL` - Enable SSL (default: false)

## Development

```bash
git clone https://github.com/daedalus/mcp-redis-server.git
cd mcp-redis-server
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/
```

## Usage

```python
from mcp_redis import mcp

# Run the server
mcp.run()
```

Or as a CLI tool:

```bash
mcp-redis
```

## API

The server exposes the following tools:

### Connection
- `redis_connect` - Connect to Redis server
- `redis_disconnect` - Disconnect from Redis server
- `redis_ping` - Ping the Redis server

### Strings
- `redis_get`, `redis_set`, `redis_mget`, `redis_mset`, `redis_del`
- `redis_incr`, `redis_decr`

### Lists
- `redis_lpush`, `redis_rpush`, `redis_lrange`, `redis_llen`

### Sets
- `redis_sadd`, `redis_srem`, `redis_smembers`, `redis_sismember`, `redis_scard`

### Hashes
- `redis_hset`, `redis_hget`, `redis_hmset`, `redis_hmget`, `redis_hgetall`
- `redis_hkeys`, `redis_hvals`, `redis_hdel`, `redis_hlen`

### Sorted Sets
- `redis_zadd`, `redis_zscore`, `redis_zrange`, `redis_zrevrange`, `redis_zcard`

### Keys
- `redis_exists`, `redis_expire`, `redis_ttl`, `redis_type`, `redis_scan`

### Server
- `redis_dbsize`, `redis_flushdb`, `redis_flushall`, `redis_info`
- `redis_config_get`, `redis_config_set`

## Configuration

Environment variables:
- `REDIS_HOST` - Redis host (default: localhost)
- `REDIS_PORT` - Redis port (default: 6379)
- `REDIS_PASSWORD` - Redis password (optional)
- `REDIS_DB` - Redis database number (default: 0)
- `REDIS_SSL` - Enable SSL (default: false)

## Development

```bash
git clone https://github.com/daedalus/mcp-redis.git
cd mcp-redis
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/
```
