意图工具设计

意图工具设计是MCP Server设计中的核心原则，强调按用户意图而非底层API粒度封装工具。其目标是让Agent用最少调用次数完成一个完整任务，减少错误和上下文消耗。

设计哲学

传统的API映射方式将底层原子能力全部暴露给Agent（如getUser、getThread、getMessages、createIssue等），导致工具链过长、调用链复杂、出错概率高、Token消耗大。

意图工具设计则将这些原子操作封装为高层任务工具。例如，不暴露6个底层工具，而是直接提供一个 create_issue_from_thread 工具，让Agent一次性完成从线程中提取信息并创建工单的完整任务。

优点

• 减少调用次数：Agent用更少的步骤完成任务
• 降低出错概率：减少中间编排环节
• 节省Token消耗：减少上下文中的工具描述和调用历史
• 提升稳定性：高层工具的内部逻辑由服务端控制，更可靠

适用场景

意图工具设计适用于大多数企业级系统，尤其是业务流程相对固定的场景。但对于超大型系统（如AWS、Cloudflare），需要与[[mcp-model-context-protocol#Code Orchestration|Code Orchestration]]模式结合使用。