Add more details on connection troubleshooting to Readme

This commit is contained in:
olaservo
2025-04-17 18:51:21 -07:00
parent 743a9341f3
commit 14bd265f9c

View File

@@ -14,12 +14,18 @@ A Model Context Protocol server that provides access to Redis databases. This se
### Connection Errors
**ECONNREFUSED**
- **Cause**: Redis server is not running or unreachable
- **Cause**: Redis/Memurai server is not running or unreachable
- **Solution**:
- Verify Redis is running: `redis-cli ping` should return "PONG"
- Check Redis service status: `systemctl status redis` (Linux) or `brew services list` (macOS)
- Verify server is running:
- 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
- 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
@@ -57,7 +63,7 @@ To use this server with the Claude Desktop app, add the following configuration
### Docker
* 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
{
@@ -69,7 +75,7 @@ To use this server with the Claude Desktop app, add the following configuration
"-i",
"--rm",
"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": [
"-y",
"@modelcontextprotocol/server-redis",
"redis://localhost:6379"
"redis://localhost:6379" // or "redis://127.0.0.1:6379" if localhost fails
]
}
}