Repository navigation
v0.1.6
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/sdk1.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 端点的用户同样无需操作——协议升级对客户端透明。