Skip to content

okf-mcp 0.5.0

Choose a tag to compare

View all tags
@mfdaves mfdaves released this 12 Aug 12:12
· 4 commits to main since this release
v0.5.0
0b43b41

Summary

okf-mcp 0.5.0 replaces the custom MCP/JSON-RPC transport with the official Model Context Protocol TypeScript SDK v2 while preserving the v0.2 catalog, graph, migration, Git-source, and review-only authoring behavior introduced in 0.4.0.

Highlights

  • Serves the modern MCP 2026-07-28 revision and the SDK compatibility path for 2025-era clients, including 2025-11-25.
  • Uses SDK-native stdio framing, negotiation, resource templates, tool dispatch, and JSON Schema validation.
  • Removes the custom protocol dispatcher and validator.
  • Preserves capability-gated tools, serialized mutations, eager catalog loading, bounded input, and masked internal errors.
  • Canonicalizes resource URIs so paths containing spaces work through standard clients.
  • Tests all MCP integration behavior through the official client SDK, including clean-installed package smoke tests in both protocol eras.

Compatibility

The CLI, stdio command, tools, resources, OKF v0.2 behavior, v0.1 migration support, and optional project mode remain available. The undocumented programmatic createServer().handle(...) dispatcher has been removed; embedded consumers should use createMcpServer() or runStdioServer().

Verification

  • 128 tests passed locally and in GitHub CI on Node 22 and Node 24.
  • The bundled OKF reference is conformant and project-valid.
  • Clean tarball installation and real stdio MCP sessions passed in modern and legacy modes.
  • The external xingu-okf v0.2 catalog passed with 451 documents, 420 concepts, 3,659 edges, and no broken links or relations.
  • Its pinned Kiliagon Suite Git-source reference resolved from the declared commit through MCP.
  • Production dependency audit reported no vulnerabilities.
Assets 2
Loading