SuperAPI AI 工具集

mcp-expert

智能体与模型

查看项目

更新于 10-16 02:35

技能介绍

用途:MCP Expert 面向 MCP 生态的构建与管理,覆盖从服务器开发、传输配置到安全、elicitation 和异步任务执行的完整生命周期,并用于设计面向智能体的工具接口,以减少 token 消耗、提升 LLM 准确率。

主要能力:涵盖面向结果的单次调用工具、参数扁平化(带描述的扁平 Zod schema)、渐进式披露(返回 mcp:// URI 供按需读取)、可重试工具、友好错误、分页(has_more + next_cursor,每次 20-50 条)、结构化输出(outputSchema 中的 JSON Schema)、Stdio 与 Streamable HTTP 传输、OAuth 2.1 with PKCE、elicitation、异步任务(tasks/get、tasks/cancel)、能力范围(如 read:docs、write:code、admin:users)、HITL 确认门、URL elicitation、扩展与带工具的 sampling。

使用方式:适用于构建 MCP 服务器、设计工具接口、配置传输、实现 OAuth 2.1、排查连接问题、使用 elicitation。可用 npx @modelcontextprotocol/inspector 交互测试工具;用 InMemoryTransport + Vitest 做单元测试;用 GitHub Actions + Inspector CLI 做 CI 冒烟测试。新能力接入时先校验服务器是否已激活,缺失则提供安装路径,并尽量用 uvx 或 npx 零安装执行。

适用场景:本地 CLI 工具用 Stdio(仅向 stderr 写日志);远程/云服务器用 Streamable HTTP(单端点,可选 SSE);旧式 HTTP+SSE 自 2025-03-26 起弃用。当前规范为 2025-11-25。

限制:不适用于应用层业务逻辑、非 MCP 的 API 设计、前端 UI 组件及与 MCP 无关的通用 HTTP API 开发。避免聊天式多轮 API、向 stdout 写日志、返回原始异常、单体服务器(建议 5-15 个工具)、硬编码密钥、单次返回大数据集、在 MCP 服务器内实现认证服务器、同步阻塞长操作、转发收到的 token、通过 elicitation 索取密钥。