用途:在设计 MCP 服务器时建立“面向模型阅读”的接口契约。模型不读源码,只依据工具名、描述与 Schema 选择工具并填参,因此每处歧义都会变成错误调用。
主要能力与设计要求: 一、工具粒度。先列出需要完成的动作(动词),一个动作对应一个工具;避免 manage(action,...) 这类带模式开关的“万能工具”,也避免近似重复工具,优先用参数区分。 二、描述即选择机制。描述需写明名称、返回内容、何时使用、何时改用别的工具。 三、Schema 严格自描述。每个属性都有类型;封闭集合用 enum;required 只列真正必填项;描述中标注单位、格式与界限(如 amount in cents、ISO 8601 date);设 additionalProperties: false;参数数量尽量少(≤6)。 四、错误契约。统一使用 { "error": "...", "hint": "..." },指出错误值与修正动作,区分可重试错误(限流、瞬时)与终止错误(鉴权失败、未找到),不泄露堆栈或密钥。 五、资源与权限。稳定、可寻址、只读的上下文用 URI 资源暴露;执行动作的用工具。为每个工具标注 read/write/destructive 并分配最小鉴权范围,默认只读,破坏性工具显式定义,不使用宽泛主密钥。
使用方式:按阶段推进——先枚举动作与工具面,再写描述与严格 Schema,然后定义错误信封,最后处理资源与鉴权;产出设计规格文件(如 mcp-interface-design-<server>.md),内含工具表、每工具 Schema 草案、错误定义、资源 URI 与质量评分结果。
质量评分全部通过才合格:可选择性、Schema 严格性、错误可用性、最小权限、工具与资源区分、输出稳定。
限制:资料未提供具体 SDK 代码实现、安装命令、收费与价格信息;该技能是设计层,传输、生命周期与能力协商仍参考 MCP 官方规范与语言 SDK 文档。