Skip to content

v0.1.6

Choose a tag to compare

@ChesterRa ChesterRa released this 02 Sep 14:09
· 6 commits to main since this release

MCP SDK v2 迁移版:升级至 2026-07-28 无状态协议,原生支持 Cloudflare Workers,向后兼容旧客户端。

升级内容

MCP SDK v2(@modelcontextprotocol/server 2.0)

  • 协议升级:从 2025-03-26(需要 initialize 握手)升级至 2026-07-28(完全无状态协议),每个请求自包含所需信息,无需会话管理
  • 向后兼容:内置 legacyStatelessFallback,旧版(2025 Streamable HTTP)客户端无需任何配置变更即可继续使用
  • 依赖精简:旧 @modelcontextprotocol/sdk 1.30(已弃用)完全移除;生产依赖从 5 个包精简至 4 个(server + iztro + lunar-javascript + zod)
  • Workers 打包缩小:gzip 638KB → 606KB(-32KB),Cloudflare Workers 免费档限额 3MB 的 20%

远程 MCP 入口简化

worker.ts 从 50 行简化为 20 行——v2 的 createMcpHandler 一行创建 HTTP handler,自动处理新协议 + 旧客户端 fallback,无需手动管理 transport 或 session。

修复

  • README 版本历史表去重与排序修复
  • 英文/日文 README 同步更新(新增历法原语工具表、清理失效的内部文档链接、版本号对齐)

升级方式

已有配置无需改动(npx -y mingpan 自动拉取 latest);锁定版本用 npx -y mingpan@0.1.6。

远程 HTTP 端点的用户同样无需操作——协议升级对客户端透明。