Skip to content

v0.1.1

Choose a tag to compare

@MohibShaikh MohibShaikh released this 13 Aug 13:48
· 26 commits to main since this release

First public release of mcp-uplift.

MCP 2026-07-28 removed the initialize handshake, sessions, ping, logging/setLevel, resource subscriptions, and server-initiated requests. This bridge wraps an existing legacy stdio MCP server and presents it to a modern, stateless client.

npx mcp-uplift npx -y @modelcontextprotocol/server-filesystem /tmp

What it translates

  • Legacy initialize handshake, exposed as server/discover
  • Server-initiated requests (sampling, elicitation, roots/list) into multi round-trip input_required results
  • Removed methods, rejected with -32601 instead of forwarded
  • Legacy -32002 resource-not-found, mapped to -32602

Verified

Output validates against the official 2026-07-28 JSON schema (DiscoverResult, InputRequiredResult, CallToolResult). Discovery and tool listing confirmed on 39 published packages, with a full MRTR round trip against the official filesystem server.

Limitations

Experimental, stdio only, and not a sandbox: a wrapped server runs with your OS permissions, so only wrap servers you trust. The wrapped process receives a minimal environment by default; forward credentials explicitly with --env NAME. Calls that can trigger a server request are serialized, and legacy notifications are dropped.

MIT, zero dependencies, Node >= 20.