SuperAPI AI 工具集

scaffold-mcp-server

智能体与模型

查看项目

更新于 10-16 08:06

技能介绍

用途:从一个工具规格文档(YAML 或 JSON,含工具名、参数、返回类型)生成完整可运行的 MCP 服务器项目,基于官方 MCP SDK,支持 TypeScript 或 Python。适用于已通过 analyze-codebase-for-mcp 或其他方式得到规格、需要新服务器项目、迁移现有集成到 MCP 协议、快速原型验证,以及需要服务器脚手架与 CI 测试框架的场景。

输入:必需为工具规格文档、目标语言(typescript 或 python)、传输类型(stdio 或 sse);可选包括输出目录、包名与版本、认证方式(none、bearer-token、api-key)、是否 Docker 打包。

主要流程与能力:1)选择语言、传输与认证,默认 TypeScript + stdio + 无认证;2)初始化项目结构并安装依赖,TypeScript 使用 npm install @modelcontextprotocol/sdk zod,Python 使用 pip install mcp pydantic;3)按规格为每类工具生成带类型参数、校验与结构化错误处理的处理器;4)配置 stdio 或 SSE 传输入口;5)用 InMemoryTransport 或子进程构建测试框架,覆盖有效与无效输入;6)生成 README、Claude Code 注册命令(claude mcp add $PACKAGE_NAME stdio "node" "dist/index.js")、Claude Desktop 配置片段及可选 Dockerfile。

限制与注意事项:需注意 SDK 导入路径随版本变化、stdio 服务器需 shebang、处理器须为异步、package.json 需 "type": "module"、Zod 模式需与规格同步、避免 console.log 污染 stdio 协议流。Node.js 需 >=18,Python 需 >=3.10。具体效果、收费与价格信息暂未提供。