modelcontextprotocol/servers
Watch
1
0
Fork
You've already forked servers
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add more details on connection troubleshooting to Readme

Browse source
This commit is contained in:
olaservo 2025-04-17 18:51:21 -07:00
commit 14bd265f9c
1 changed files with 12 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

18
src/redis/README.md
View file

@ -14,12 +14,18 @@ A Model Context Protocol server that provides access to Redis databases. This se
### Connection Errors ### Connection Errors
**ECONNREFUSED** **ECONNREFUSED**
- **Cause**: Redis server is not running or unreachable - **Cause**: Redis/Memurai server is not running or unreachable
- **Solution**: - **Solution**:
- Verify Redis is running: `redis-cli ping` should return "PONG" - Verify server is running:
- Check Redis service status: `systemctl status redis` (Linux) or `brew services list` (macOS) - Redis: `redis-cli ping` should return "PONG"
- Memurai (Windows): `memurai-cli ping` should return "PONG"
- Check service status:
- Linux: `systemctl status redis`
- macOS: `brew services list`
- Windows: Check Memurai in Services (services.msc)
- Ensure correct port (default 6379) is not blocked by firewall - Ensure correct port (default 6379) is not blocked by firewall
- Verify Redis URL format: `redis://hostname:port` - Verify Redis URL format: `redis://hostname:port`
- If `redis://localhost:6379` fails with ECONNREFUSED, try using the explicit IP: `redis://127.0.0.1:6379`
### Server Behavior ### Server Behavior
@ -57,7 +63,7 @@ To use this server with the Claude Desktop app, add the following configuration
### Docker ### Docker
* when running docker on macos, use host.docker.internal if the server is running on the host network (eg localhost) * when running docker on macos, use host.docker.internal if the server is running on the host network (eg localhost)
* Redis URL can be specified as an argument, defaults to "redis://localhost:6379" * Redis URL can be specified as an argument, defaults to "redis://localhost:6379" (use "redis://127.0.0.1:6379" if localhost fails)
```json ```json
{ {
@ -69,7 +75,7 @@ To use this server with the Claude Desktop app, add the following configuration
"-i", "-i",
"--rm", "--rm",
"mcp/redis", "mcp/redis",
"redis://host.docker.internal:6379"] "redis://host.docker.internal:6379"] // For macOS/Windows, or use "redis://127.0.0.1:6379" for direct connection
} }
} }
} }
@ -85,7 +91,7 @@ To use this server with the Claude Desktop app, add the following configuration
"args": [ "args": [
"-y", "-y",
"@modelcontextprotocol/server-redis", "@modelcontextprotocol/server-redis",
"redis://localhost:6379" "redis://localhost:6379" // or "redis://127.0.0.1:6379" if localhost fails
] ]
} }
} }