openapi
将OpenAPI服务转换为MCP协议，赋能AI代理调用外部API。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：openapi。 它的用途是：将OpenAPI服务转换为MCP协议，赋能AI代理调用外部API。 详细介绍见：https://321skill.com/skills/openapi-openapi-mcp-proxy/ 请根据该页面的说明完成安装。
使用示例
“帮我查询一下服务器当前的负载状态。” 由于你已经通过mcp-proxy将运维监控系统的OpenAPI接入，AI会自动识别可用的‘查询服务器状态’工具，并调用对应的API获取实时数据返回给你。或者，你可以直接说：“使用订单API，创建一笔新的测试订单。” AI会理解并填充必要的参数，完成API调用。
介绍
该工具旨在解决AI代理（如Claude、Cursor中的AI）难以直接调用现有OpenAPI服务的痛点。它作为一个命令行代理，将标准的OpenAPI规范无缝转换为MCP（Model Context Protocol）协议，使AI能够安全、结构化地访问和使用这些API。
使用时，开发者只需运行该命令行工具，并指定目标OpenAPI服务的规范文件或URL，工具便会启动一个MCP服务器。随后，在支持MCP的AI平台（如Claude Desktop）中配置连接到此服务器，AI即可获得该OpenAPI定义的所有工具能力，并能在对话中直接调用。
它非常适合需要将现有API能力快速集成到AI工作流中的开发者，特别是智能体开发者、全栈开发者和运维开发人员。无论是内部系统接口、第三方服务API，还是自建的工具集，都可以通过此方式被AI直接利用。
建议在使用前确保目标OpenAPI规范是完整且正确的。由于它充当了代理角色，需注意网络连通性和API密钥等敏感信息的管理，建议在受信任的环境或通过环境变量配置密钥，避免直接暴露在AI对话上下文中。
核心特点
核心区别在于它专注于将已有的、标准的OpenAPI服务直接“翻译”成AI可理解的MCP协议，无需为AI单独开发适配层，实现了对现有API资产的零成本复用。与那些需要为特定API手动编写MCP工具的工具相比，它提供了通用、自动化的转换能力。
注意事项
不适合转换非标准、文档不全或依赖复杂认证流程（如需要交互式登录）的OpenAPI服务。
常见问题
这个工具和直接让AI调用API有什么区别？
它通过MCP协议提供了结构化、安全的调用方式，AI能自动理解API参数和用途，无需在提示词中拼接复杂请求，也避免了在对话中暴露API密钥。
支持哪些OpenAPI版本？
主要支持OpenAPI 3.x规范，这是目前主流的API描述格式。