SuperAPI AI 工具集

mcp-server-design

设计与创作

查看项目

更新于 10-16 01:14

技能介绍

用途:该技能提供设计 MCP(Model Context Protocol)服务器的最佳实践,目标是让工具能被 LLM 智能体高效使用。核心观点是「为智能体而设计,而非为自动化而设计」——LLM 更像人类思考者,而非 API 消费者。

主要能力与原则:三大支柱为「给全信息」(提供完整可执行的信息)、「减少步骤」(降低完成任务所需操作)、「减少路径」(限制 LLM 需要判断的分支)。工具设计原则包括:围绕用户任务而非 API 端点设计工具;控制工具数量,建议从 5-10 个核心工具起步,仅在评估显示必要时增加;按用途而非实现命名工具(如用 notify-team 而非 post-slack-message);对复杂流程用一个任务级工具替代多个原子步骤工具。

使用方式:资料给出基于 xmcp 的代码结构示例,工具通过 zod 定义 schema,并导出 metadata(含 name 与 description),默认导出处理函数。示例包括 prepare-database-migration、deploy-changes 等任务型工具。

适用场景:创建新 MCP 服务器、设计 MCP 工具、改进现有 MCP 服务器。

限制与提醒:资料列出危险信号,如单个服务器工具超过 15 个、以 HTTP 方法或端点命名工具、声称「什么都能做」的通用工具、完成单一任务却需多次调用的工具。何时新建或合并工具的判断框架也已给出。更深入的示例与反模式见 references/design-principles.md。具体安装命令、收费与平台信息暂未提供。