新功能 (2026-06-19) — MCP 結構化工具輸出

MCP 伺服器現在支援 2025-06-18 的**結構化工具輸出**規範:工具可宣告 outputSchema,其 dict 結果會在 tools/call 回應中以 structuredContent 回傳(與一般的文字 content 並列)。MCP 用戶端 與 LLM 即可消費經 schema 驗證的型別化物件,而非重新解析文字——省 token、 少出錯。純標準庫;屬 MCP 框架增強(不新增 AC_* 指令)。

宣告輸出 schema

from je_auto_control.utils.mcp_server.tools import MCPTool

MCPTool(
    name="ac_validate_rows", description="...",
    input_schema=..., handler=validate_rows,
    output_schema={"type": "object", "properties": {
        "ok": {"type": "boolean"}, "errors": {"type": "array"}}},
)

to_descriptor() 會在 tools/list 中包含 outputSchema;當 tools/call 的 handler 回傳 dict 時,結果會包含 structuredContent。 未宣告 outputSchema 的工具行為不變;非 dict 結果不會產生 structuredContent。

首個採用的內建工具是 ac_validate_rows``(資料品質驗證),其 ``{ok, total, valid_count, invalid_count, errors, ...} 結果現在已型別化; 其他工具可透過加上 output_schema 逐步採用。