Skip to content

v0.6.2 — MCP startup optimization

Choose a tag to compare

View all tags
@Filippo-Venturini Filippo-Venturini released this 10 Apr 12:35
· 27 commits to main since this release
v0.6.2
b00c5b8
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v0.6.2 — MCP startup optimization

CtxVault v0.6.2 fixes the MCP handshake timeout issue that prevented the server from connecting to Claude Desktop and other MCP clients when embedding model initialization took longer than 60 seconds.

Fixed

MCP handshake timeout — moved embedding model warmup to a background task, allowing the MCP server to become available immediately (typically under 1 second) instead of blocking until warmup completes. The server now connects reliably to Claude Desktop even when the embedding model takes 1-2 minutes to initialize on first startup.

Graceful warmup handling — embedding-dependent tools (query, write_doc, write_skill) now return a clear "still warming up, please retry in 30-60 seconds" message if called before initialization completes, instead of hanging or timing out silently. This provides better user feedback during the warmup period.

Added

Warmup status tool — new warmup_status tool allows clients to check if the embedding model has finished initializing. Returns ready or warming_up status with a human-readable message.

What's unchanged

All CLI commands, API endpoints, vault operations, and existing MCP tools work exactly as before. The only user-facing change is improved reliability when connecting via MCP and clearer feedback during server startup.

Assets 2
Loading