norboten · cheat sheet

The Stream That Stops — a proxy in front of a remote MCP server — cheat sheet

mcp, networking
nginx -t && nginx -s reload                         # here: sudo proxy-restart
proxy_buffering off;                                # pass the stream on as it arrives
proxy_read_timeout 300s;                            # longest silence between two reads
proxy_http_version 1.1; proxy_set_header Connection "";
sudo tail /var/log/nginx/error.log                  # "upstream timed out … while reading upstream"
ss -Hltn "sport = :8931"                            # who listens, on which address
curl -N -X POST -H 'Accept: application/json, text/event-stream' …    # -N: do not buffer either