SuperAPI AI 工具集

build-mcp-server

智能体与模型

查看项目

更新于 10-15 16:50

技能介绍

用途:在用户提出“构建 MCP 服务器”“创建 MCP”“把 API 包装给 Claude”“暴露工具”等需求时,引导开发者完成设计到落地,避免选错形态导致返工。先做发现,不急于写代码。

主要能力:提供分阶段指引。阶段一通过对话式提问厘清连接对象(云 API、本地进程、硬件或纯逻辑)、使用者范围、动作数量、是否需要调用中用户输入或富 UI、上游认证方式。阶段二推荐部署模型:远程 streamable-HTTP(默认推荐,零安装、统一升级、OAuth 可用、跨宿主)、MCP app(远程 HTTP 加交互式 UI 组件,基于 iframe 与 @modelcontextprotocol/ext-apps)、MCPB(打包本地服务器,免装 Node/Python)、本地 stdio(npx/uvx,仅适合个人原型)。阶段三选工具设计模式:动作少于约 15 个用一动作一工具;数十到数百个接口用 search + execute,并可把 3–5 个高频动作提升为独立工具。阶段四选框架:默认官方 TypeScript SDK(@modelcontextprotocol/sdk),或 FastMCP 3.x(PyPI 包 fastmcp,非官方 mcp SDK 内置的 FastMCP 1.0)。阶段五按选型内联脚手架或转交 build-mcp-app、build-mcpb 技能。阶段六在 Claude 中测试(Settings → Connectors 添加自定义连接器,本地服务器可用 Cloudflare tunnel)、对照审阅标准与提交清单并提交目录。

使用方式:先加载 Claude 专属上下文,获取 https://claude.com/docs/llms-full.txt,因为 MCP 规范是通用的,Claude 有额外认证类型、审阅标准与限制。阶段一未获答案前不要开始脚手架。可参考内置文件:references/remote-http-scaffold.md、references/deploy-cloudflare-workers.md、references/tool-design.md、references/auth.md、references/resources-and-prompts.md、references/elicitation.md、references/server-capabilities.md、references/versions.md。

适用场景与限制:适合需要把外部 API 或本地能力接入 Claude 的开发者,含涉及 OAuth(CIMD 优先或 DCR)的远程服务器。Elicitation 属规范原生、无需 UI 代码,但宿主支持较新(Claude Code ≥2.1.76,Desktop 未确认),SDK 在客户端未声明该能力时会抛错,必须先检查 clientCapabilities.elicitation 并提供回退。除工具外还有 Resources、Prompts、Elicitation、Sampling 等原语,多数服务器只用工具即可。其他框架、具体价格与效果等资料未提供。