SuperAPI AI 工具集

build-mcp-server-sdk-v1

编程与开发

查看项目

更新于 10-16 03:38

技能介绍

用途:该技能面向使用 @modelcontextprotocol/sdk v1.x(单包、基于 Zod 的 TypeScript SDK)构建或维护 MCP 服务器的场景,包括新建服务器、为现有 v1 服务器增加工具/资源/提示,以及从已废弃 API 迁移到当前 API。

主要能力:覆盖 McpServer、registerTool、registerResource、registerPrompt、传输层(stdio、Streamable HTTP)、OAuth 2.1、会话与部署;提供 v1 与 v2 的区分信号(依赖包名、导入路径、处理函数签名、HTTP 传输类、模块系统、Node 版本、Zod 版本),并给出检测脚本与脚手架脚本,如 bash scripts/check-mcp-sdk-v1-version.sh [project-dir]、bash scripts/scaffold-v1-server.sh <target-dir> <server-name> [stdio|http-stateful|http-stateless]。

必要用法:安装依赖 npm install @modelcontextprotocol/sdk zod;HTTP 传输另需 npm install express。核心规则包括使用 McpServer(不用底层 Server)、使用 registerTool/registerResource/registerPrompt(不用已废弃的 tool()/resource()/prompt())、输入输出用 Zod、HTTP 用 StreamableHTTPServerTransport(不用 SSEServerTransport)、工具需设置 annotations(readOnlyHint、destructiveHint、idempotentHint、openWorldHint)。校验建议先本地构建与单测,再用 npx @anthropic-ai/mcp-inspector 等做最小流程测试。

适用场景:需要本地 stdio 或远程 HTTP 的 MCP 服务器开发、已有 v1 服务器扩展、认证接入、传输与会话加固、v1 运行错误诊断。

限制:明确不适用于导入 @modelcontextprotocol/server 等拆分包的 v2 项目、使用 mcp-use 包装库的项目,以及 v1 迁移到 v2 的转换任务;这些应改用对应技能。其余如具体收费与价格等,资料暂未提供。