MCP 服务设计指南
分类：开发工具
它能帮你做什么
【是什么】一份「高质量 MCP 服务」设计方法论：如何把外部 API/服务封装成大模型好用的工具（命名、入参出参、错误处理、评测）。 【适合谁】想给自己的产品接大模型能力的开发者；要设计 tool/function calling 接口的后端同学。 【怎么用】告诉我你想让模型能做什么（如「查订单状态」），我按方法论给工具命名、Zod/Pydantic 入参 schema、清晰错误提示、只读/危险标注，并产出可落地的代码骨架（Python/TS）。 【边界】纯网页环境只做设计 + 代码骨架建议，不在此运行服务；拿到骨架后在你本地环境实现并自检。（注：AI生成内容仅供参考，不构成专业建议）
怎么用
用法：说「我想让模型能查天气，帮我设计这个 MCP 工具」，我会给命名、入参出参、错误提示与代码骨架。
基本信息
| 是否收费 | 免费 |
|---|---|
| 许可 | Apache-2.0 |
| 原作者 | Anthropic, PBC |
| 上游仓库 | anthropics/skills |
| 评级 | S |
| 使用次数 | 6 |
信任状
- ✅ 已通过 AI8188 真实实测：用真实输入跑过一遍，输入、输出、耗时原样公开，可自行核对。
- 🔌 可被 AI 助手直接调用执行：经 MCP（https://www.ai8188.com/mcp）用 run_skill 真实执行，返回不可伪造的执行证明 trace_id，可用 verify_execution 独立核验。
- 📜 来源可溯：开源许可 Apache-2.0 · 原作者 Anthropic, PBC · 上游 anthropics/skills
- 🔒 密钥不出本机：运行所用的模型 API 密钥只存在用户自己的浏览器，不上传平台、不入库。
实测记录（真实跑过的证据）
真实测试输入：我需要一个能自动处理客户查询订单状态的工具，接口调用频率每天至少5000次。（请直接交付可使用的成品，不要反问、不要说做不到、不要让我去别处查）
真实输出片段：为了创建一个能够自动处理客户查询订单状态的工具，我们需要设计一个MCP服务。以下是该服务的核心设计： ### 1. 命名与可发现性 - **名称**：order_status_checker - **描述**：用于自动查询订单状态的工具。 ### 2. 上下文管理 - **工具描述**：简化描述，支持过滤/分页，返回聚焦订单状态数据。 ### 3. 可执行的报错 - **错误信息**：提供具体错误原因和解决步骤。 ### 4. 输入/输出 schema - **输入**： - `order_id`: 订单ID，必填。 - **输出**： - `status`: 订单状态（如：已发货、待支付、已完成等）。 - `message`: 订单状态的描述信息。 ### 5. 标注 - `idempotentHint`: 该工具调用是幂等的，多次调用不会改变结果。 ### 6. 评测 - 设计10个测试案例，验证工具的有效性。 ### 可落地代码骨架（Python） ```python from typing import Dict def order_status_checker(order_id: str) -> Dict[str, str]: # 这里是伪代码，实际应用中需要替换为对订单服务API的调用 if not order_id:
判定：✅ 通过 · 引擎 deepseek · Fri Sep 25
说明：以上为 AI8188 用真实输入在平台通道真跑该技能的记录，输入、输出、产出原样公开，可自行核对。
实测记录（公开可查）：https://www.ai8188.com/api/reports?type=skill&id=82
运行
本技能可直接在 AI8188 网页内运行（无需安装）：https://www.ai8188.com/run/skill/82
页面：https://www.ai8188.com/s/mcp-builder-zh 全量实测报告：https://www.ai8188.com/reports
（本页是给搜索引擎与 AI 助手抓取的静态版本；在浏览器打开会进入完整交互界面。技能提示词正文不在本页公开。）