Skip to content

Commit a3e4f5f

Browse files
olaservoshivdeepak
authored andcommitted
Add more details on connection troubleshooting to Readme
1 parent a90ba84 commit a3e4f5f

File tree

1 file changed

+12
-6
lines changed

1 file changed

+12
-6
lines changed

src/redis/README.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -14,12 +14,18 @@ A Model Context Protocol server that provides access to Redis databases. This se
1414
### Connection Errors
1515

1616
**ECONNREFUSED**
17-
- **Cause**: Redis server is not running or unreachable
17+
- **Cause**: Redis/Memurai server is not running or unreachable
1818
- **Solution**:
19-
- Verify Redis is running: `redis-cli ping` should return "PONG"
20-
- Check Redis service status: `systemctl status redis` (Linux) or `brew services list` (macOS)
19+
- Verify server is running:
20+
- Redis: `redis-cli ping` should return "PONG"
21+
- Memurai (Windows): `memurai-cli ping` should return "PONG"
22+
- Check service status:
23+
- Linux: `systemctl status redis`
24+
- macOS: `brew services list`
25+
- Windows: Check Memurai in Services (services.msc)
2126
- Ensure correct port (default 6379) is not blocked by firewall
2227
- Verify Redis URL format: `redis://hostname:port`
28+
- If `redis://localhost:6379` fails with ECONNREFUSED, try using the explicit IP: `redis://127.0.0.1:6379`
2329

2430
### Server Behavior
2531

@@ -57,7 +63,7 @@ To use this server with the Claude Desktop app, add the following configuration
5763
### Docker
5864

5965
* when running docker on macos, use host.docker.internal if the server is running on the host network (eg localhost)
60-
* Redis URL can be specified as an argument, defaults to "redis://localhost:6379"
66+
* Redis URL can be specified as an argument, defaults to "redis://localhost:6379" (use "redis://127.0.0.1:6379" if localhost fails)
6167

6268
```json
6369
{
@@ -69,7 +75,7 @@ To use this server with the Claude Desktop app, add the following configuration
6975
"-i",
7076
"--rm",
7177
"mcp/redis",
72-
"redis://host.docker.internal:6379"]
78+
"redis://host.docker.internal:6379"] // For macOS/Windows, or use "redis://127.0.0.1:6379" for direct connection
7379
}
7480
}
7581
}
@@ -85,7 +91,7 @@ To use this server with the Claude Desktop app, add the following configuration
8591
"args": [
8692
"-y",
8793
"@modelcontextprotocol/server-redis",
88-
"redis://localhost:6379"
94+
"redis://localhost:6379" // or "redis://127.0.0.1:6379" if localhost fails
8995
]
9096
}
9197
}

0 commit comments

Comments
 (0)