SuperAPI AI 工具集

mcp-to-skill

智能体与模型

查看项目

更新于 10-16 00:20

技能介绍

用途:将 MCP 服务器转换为按需加载的技能,减少上下文占用。MCP 工具 schema 每轮都注入系统提示(每个工具约 500-2000 tokens),而技能在通过 view 加载前不消耗 token;典型 4-5 个 MCP、20-40 个工具的场景每轮可回收 10,000-30,000 tokens。

主要能力:提供转换与保留的决策框架——包装 REST API、CLI 工具、推理/规划模式或低频使用的 MCP 适合转换;维护服务端状态、二进制协议/流式、实时事件订阅或极小(1-2 个工具、低于 500 tokens)的 MCP 建议保留;也可混合处理,把无状态工具转为技能、有状态部分保留为精简 MCP。

使用方式:分 5 个阶段,每阶段结束需用户确认。1) 发现:从当前会话工具、MCP 配置文件(Claude Desktop、Cursor、Claude Code)、服务器源码、包注册表或用户提供的 schema 获取工具定义,产出结构化清单。2) 分类:按替换类别(REST_API、CLI_WRAPPER、LOGIC_PATTERN、FILE_OP、STATEFUL、COMPOSITE)与使用频率(ESSENTIAL、NICE_TO_HAVE、RARELY_USED)分类。3) 替换策略:为每个工具设计具体替换命令、参数映射、输出解析与错误处理,并识别多工具工作流。4) 生成:产出技能包,含 SKILL.md(frontmatter、快速参考表、前置条件、核心操作、常见工作流、错误处理)与必要时 references/。5) 验证:用脚本估算 token 节省,生成测试场景并给出迁移清单。

限制:有状态工具、二进制协议与流式场景难以干净转换;未知 API 需先调研,不能猜测端点;多步 OAuth 或凭据管理需显式配置环境变量;部分覆盖(如 90%)通常优于强行 100% 转换。生成技能不得硬编码凭据,SKILL.md 建议控制在 500 行以内。