Skip to main content

商务 MCP Server

5.1 电商MCP Server的工具设计

一个完整的电商MCP Server通常包含以下工具:

5.2 工具设计原则

单一职责

每个工具做一件事。不要把搜索和下单放在同一个工具里。AI模型会根据上下文自动组合多个工具。

清晰的描述

工具的 description 直接影响AI模型何时选择使用它。写清楚:
  • 这个工具做什么
  • 什么场景下应该使用
  • 返回什么类型的数据

合理的参数设计

  • 必填参数要少(降低使用门槛)
  • 可选参数提供默认值
  • 参数描述要具体

善用structuredContent

对于需要程序化处理的返回数据(如价格计算、库存对比),同时提供 content(给LLM阅读)和 structuredContent(给程序处理):

善用isError区分业务错误

工具执行中遇到的业务问题(如商品不存在、库存不足),使用 isError: true 而不是抛出异常:

5.3 完整电商MCP Server示例

5.4 商务Resources设计

除了工具,电商Server还可以暴露静态上下文作为Resources,让AI代理理解你的业务:
AI代理在回答”你们支持退货吗”这类问题时,会自动读取相关资源作为上下文。

5.5 权限和安全

商务Server需要特别注意权限控制: 远程部署时,使用OAuth 2.1认证,确保用户身份和权限正确。对于需要认证的工具,可以通过Elicitation请求用户登录,或依赖Host应用已有的OAuth集成。

5.6 商务MCP Server与其他协议的关系

一个完整的Agentic Commerce系统中,MCP作为AI应用与你的商务系统之间的”连接层”,而UCP/ACP/OTR处理具体的商务协议逻辑。
下一章: 资源与提示词 — Resources和Prompts的深入使用