让长时间MCP工具调用响应取消请求

目标

让用户取消等待中的工具操作时，服务端尽快停止或安全收尾。

步骤

1. 识别可能长时间等待的I/O或计算步骤，并定义取消后的安全状态。 [mcp-cancel]
2. async @mcp.tool() handler把可await清理放进 finally；清理中的await包在 anyio.move_on_after(5, shield=True)。 [mcp-cancel]
3. 若工具是普通 def线程函数，在工作单元之间调用 anyio.from_thread.check_cancelled()；放弃调用对应取消等待该call的task或触发read timeout。 [mcp-cancel]
4. Streamable HTTP部署不要启用 json_response=True（现代连接）或 stateless_http=True（旧连接），两者会让handler无法收到取消。 [mcp-cancel]
5. 在慢速测试任务中触发取消，验证handler停止、连接释放且结果标注为取消。 [mcp-cancel]

验证方式

取消async handler后finally执行；await清理在5秒上限内完成，普通def在检查点退出，且HTTP连接配置允许取消传播。

故障处理

若取消无效，检查handler是否把取消令牌传递给下游I/O。