Repository navigation
v3.1.0
Fixed
- The HTTP transport could only serve one client at a time.
--httpmode shared a singleMcpServeracross every connection, but the MCP SDK binds one server to exactly one transport — so a second concurrent client failed withAlready connected to a transport(HTTP 500). Each session now gets its own server instance. The same latent fault affected the legacy/sseendpoint, where a second connection could displace the first; it is fixed there too. - HTTP sessions are now durable.
POST /mcpissues anMcp-Session-Idoninitializeand reuses it on later requests, instead of treating every request as a fresh stateless exchange. Clients that expect session continuity (per the Streamable HTTP spec) no longer seeSession terminated. GET /mcpandDELETE /mcpnow work instead of always returning 405.GETopens the server-to-client stream for a session;DELETEterminates it.
Added
- Session limits, so an unauthenticated port cannot exhaust memory. Each session pins a full server (~3.5 MB), so sessions are capped (default 50,
--maxSessions/PAPERLESS_MAX_SESSIONS) and idle sessions are evicted (default 30 minutes,--sessionIdleMinutes/PAPERLESS_SESSION_IDLE_MINUTES). Past the cap,initializeis refused with HTTP 503 rather than allocating. A client that is actively connected — including one holding aGET /mcpstream open — is never evicted, however long it sits idle./sseconnections draw from the same cap, so it is refused with 503 too once the budget is spent — it was previously unbounded even after/mcpwas capped. SIGTERM/SIGINTnow tear down live sessions before exit.
Changed (BREAKING)
--httpmode is stateful. Clients that never callinitialize, or that call it and then ignore the returnedMcp-Session-Id, previously worked against the stateless server and now receive HTTP 400. Sendinitializefirst and echo the session id back on subsequent requests. Only--httpis affected — stdio behaviour is unchanged.GET/DELETEon/mcpwithout a session id return 400 (was 405); with an unknown or expired session id they return 404.- The HTTP startup log line dropped the word
Stateless.
Full Changelog: v3.0.0...v3.1.0