Skip to content

akb-mcp v2.1.0 — survive backend/VPN outages without a session restart

Choose a tag to compare

View all tags
@byongjohnhan-oss byongjohnhan-oss released this 05 Aug 12:17
· 214 commits to main since this release
Immutable release. Only release title and notes can be modified.
akb-mcp-v2.1.0
36c0da4
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Resilience release for the akb-mcp stdio proxy. A long VPN/backend outage used to drop the AKB server from a client's tool namespace for the rest of the session (mcp__akb__* gone until restart).

Fix — decouple client-visible liveness from backend reachability:

  • initialize is answered locally, so the server always registers even with the backend down.
  • tools/list degrades to the local file tools when unreachable (instead of erroring); the backend list is cached and served thereafter.
  • A background reconnect monitor (exponential backoff 1s→30s) restores the session and pushes notifications/tools/list_changed on recovery — the full toolset reappears without a session restart.
  • Tool calls never kill the proxy; a connection error retries then surfaces a normal JSON-RPC error.
  • Short connect-phase timeout (AKB_MCP_CONNECT_TIMEOUT_MS, default 10s) for blackhole detection, separate from the 5-min response timeout.

No change to tool behavior, auth, or the file-transfer path. Backward compatible.

npm: https://www.npmjs.com/package/akb-mcp/v/2.1.0
Merged in #329.

Assets 3
Loading