Skip to content

v1.5.0 - Bidirectional MCP & JSON Schema

Choose a tag to compare

@TASure TASure released this 26 Sep 06:28
· 43 commits to main since this release

sureai v1.5.0 — MCP 双向能力

本版本让 sureai 从"MCP 客户端"升级为双向 MCP:新增 MCP Server,可把统一的多平台能力反向暴露给任何 MCP 客户端。27 模块、855 测试 0 失败。

🆕 Added

  • MCP Server(sure-ai-mcp-server):一个 MCP 连接即可调用 sureai 背后的全部平台能力。
    • 双协议自适应:有状态 2025-06-18(initialize 握手)与无状态 2026-07-28(_meta 携带协议版本、server/discover 能力广告、工具 ttlMs/cacheScope);
    • 双传输零依赖:stdio(NDJSON,64MB 帧上限)与 Streamable HTTP(JDK 内置 HttpServer,JSON/SSE 双形态、CORS);
    • 注册式工具:McpServerTool 按需挂载,预置 SureAiTools 工厂(chat / embed / image),支持单 AiClient 与多客户端 Map 路由;server 核心不硬依赖任何平台模块,保持平台隔离;
    • 已通过 sureai 自有 McpClient 的端到端回环验证(initialize → tools/list → tools/call)。
  • JsonSchemaGenerator(core):纯 JDK 反射零依赖生成 JSON Schema(Draft 2020-12),覆盖 POJO/record/嵌套/集合泛型/枚举/时间类型/循环引用;同时为 MCP 工具自动生成 inputSchema。

⚙️ Changed

  • 平台能力精确声明:Azure / Doubao / Qwen / Zhipu 的 capabilities() 从全量兜底收口为实际能力(独立 Video/TTS/STT Client 承载的能力不再由主 Client 声明),调用未声明能力立即抛 AiException;无法核实的 MODERATION 等保守保留。

📊 质量

  • 855 测试 0 失败(+43);core 覆盖率 86.7%、mcp-server 78.5%
  • checkstyle / spotbugs / license 门禁全绿;运行期第三方依赖仍有且仅有 sure-core:0.2.0
  • 文档 docs/mcp-server.md(含 Claude Desktop 配置示例),新增 McpServerDemo / McpHttpServerDemo

说明:无状态规范的 MRTR / subscriptions / OAuth 扩展面为实验性(规范仍在 draft),已在文档注明。

Full Changelog: v1.4.0...v1.5.0