🛠️ OpenAPI to MCP Generator 是什么？
openapi-mcp-generator 是一个命令行工具，它能把你已有的 OpenAPI 规范文件，自动转换成符合 MCP 协议的接口工具。你不需要手动定义每个 API 如何被大语言模型调用，也不用处理参数映射或响应解析。只要提供一个有效的 OpenAPI JSON 或 YAML 文件，它就能生成一套可以直接集成到 LLM 应用中的上下文操作模块。
为什么需要它？
以往让大语言模型调用业务 API，通常要写一堆胶水代码：定义工具名称、描述功能、手动匹配请求字段、处理认证、校验返回格式……这个过程不仅重复，还容易出错，尤其是当 API 数量多或频繁变更时，维护成本很高。
有了 openapi-mcp-generator，你不再需要从零开始封装。只要团队已经有 OpenAPI 文档（比如用 Swagger 或 FastAPI 生成的），就可以直接作为输入，一键生成标准化的 MCP 工具。API 变了？重新运行一次命令，新的接口能力就自动同步到位。这减少了人为遗漏，也避免了前后端联调时因文档不同步导致的问题。
核心能力速览
自动生成 MCP 工具定义：
工具会解析 OpenAPI 中的所有路径、方法、参数和响应结构，自动生成对应的 MCP 工具描述。LLM 能准确知道哪个接口接受什么输入、返回什么数据，无需人工撰写提示词或注释。
支持多种通信方式：
生成的工具默认支持 stdio、HTTP 和 WebSocket 三种传输模式。你可以把它嵌入命令行脚本、部署为独立服务，或者接入实时交互系统，适配不同运行环境而无需修改逻辑。
TypeScript 开箱即用：
输出代码基于 TypeScript，自带类型定义和清晰的配置结构。编辑器能直接提示函数参数、响应字段和错误类型，减少调试时间。项目骨架也已经组织好，拿过来就能跑。
与现有开发流程兼容：
不强制改变你的架构。无论你是单体服务还是微服务，只要 API 有 OpenAPI 文档，就能接入。适合在 CI 流程中自动化执行，确保模型始终使用最新的接口定义。
适合谁？怎么用？
如果你是后端或全栈开发者，正在构建需要让 LLM 调用内部服务的智能应用，这个工具能帮你快速暴露 API 能力，而不必手写每一个工具绑定。
特别适合用于：
- 内部管理系统的自动化操作（如查订单、发通知）
- 第三方平台 API 的统一接入（如 CRM、支付、短信）
- 快速搭建可演示的 AI 助手原型
- 团队协作中统一接口封装标准
建议在已有 OpenAPI 文档的基础上尝试。运行一条命令，生成代码后稍作配置，就能接入主流 LLM 框架。不需要深入理解 MCP 协议细节，也能让模型正确调用你的接口。
