OpenAPI 转 MCP 工具骨架

原名：mcp-server-builder

从接口契约整理工具定义、校验结构和服务端起步代码。

中文 Skills 技能说明

想让桌面 AI 调用已有业务接口时，先从契约生成工具骨架。提供 OpenAPI 文档、鉴权方式、读写边界和错误结构，技能用包内 Python 工具提取操作、生成 Python 或 TypeScript 起步服务并校验定义，交付映射与联调清单。YAML 文档可能需要 PyYAML，SDK、运行时和接口账号另备。生成不等于服务器已可用，也不改变原接口权限；敏感工具必须有确认和幂等设计，暴露、部署及真实写入由负责人审核。

上游能力依据

上游原始适用说明：Design and ship production-ready MCP (Model Context Protocol) servers from OpenAPI contracts instead of hand-written tool wrappers. Python and TypeScript support, schema validation, safe evolution. Use when exposing an existing API as an MCP server, building tool integrations for Claude or Codex or Cursor, or scaffolding an MCP project from scratch.

上游 SKILL.md 主要章节（保留原文标题）：

• Overview
• Core Capabilities
• When to Use
• Key Workflows
• 1. OpenAPI to MCP Scaffold
• 2. Validate MCP Tool Definitions
• 3. Runtime Selection
• 4. Harden for Production
• Script Interfaces
• Reference Material

使用边界

先核对运行环境、账号、区域、依赖和最小权限。创建资源、改配置、发布服务或产生费用前必须让使用者确认。

作者、翻译与许可证

原作者

Alireza Rezvani 与 claude-skills contributors

中文翻译

CEOFans翻译

许可证

MIT

上游来源

https://github.com/alirezarezvani/claude-skills/tree/27cfcd0fb0a41f60adffcbd5271fdf8839f86ed2/engineering/skills/mcp-server-builder

适用范围

平台：linux、macos、windows；标签：MCP 与工具、OpenAPI 转 MCP 工具骨架、开源技能

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。