From 2ceaac049cb5dde499583562dfcdcb0f6210938b Mon Sep 17 00:00:00 2001 From: Rene Cannao Date: Tue, 13 Jan 2026 17:02:48 +0000 Subject: [PATCH] docs: Add logging section to bridge README Added documentation for: - Log file location (/tmp/proxysql_mcp_bridge.log) - What information is logged - How to use logs for debugging --- scripts/mcp/STDIO_BRIDGE_README.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/scripts/mcp/STDIO_BRIDGE_README.md b/scripts/mcp/STDIO_BRIDGE_README.md index f6aff7ee8..935109f2b 100644 --- a/scripts/mcp/STDIO_BRIDGE_README.md +++ b/scripts/mcp/STDIO_BRIDGE_README.md @@ -107,8 +107,36 @@ Once configured, you can ask Claude: > "Show me 5 rows from the orders table" > "Run SELECT COUNT(*) FROM customers" +## Logging + +For debugging, the bridge writes logs to `/tmp/proxysql_mcp_bridge.log`: + +```bash +tail -f /tmp/proxysql_mcp_bridge.log +``` + +The log shows: +- stdout writes (byte counts and previews) +- tool calls (name, arguments, responses from ProxySQL) +- Any errors or issues + +This can help diagnose communication issues between Claude Code, the bridge, and ProxySQL. + ## Troubleshooting +### Debug Mode + +If tools aren't working, check the bridge log file for detailed information: + +```bash +cat /tmp/proxysql_mcp_bridge.log +``` + +Look for: +- `"tools/call: name=..."` - confirms tool calls are being forwarded +- `"response from ProxySQL:"` - shows what ProxySQL returned +- `"WRITE stdout:"` - confirms responses are being sent to Claude Code + ### Connection Refused Make sure ProxySQL MCP server is running: ```bash