openapi2mcp

关于 openapi2mcp

openapi2mcp 是一款面向 FastMCP 的代码生成 MCP，专注于将 OpenAPI（Swagger）规范 一键转换为可运行的 FastMCP 服务器代码。只要提供 OpenAPI 文档（URL 或本地文件），即可自动产出对应的接口实现，省去逐一手写工具（Tool）定义的繁琐流程。

它能做什么

• 解析 OpenAPI 3.x 文档，提取 paths、operations、parameters 与 requestBody。
• 为每个接口自动生成 FastMCP 的 @tool 装饰器代码，含参数类型推断与必填校验。
• 支持自定义生成路径、模板与项目骨架（部分版本可配置鉴权前缀）。
• 若 OpenAPI 中包含 securitySchemes（如 API Key、Bearer），可在生成的代码中按需填入对应的鉴权参数。

是否需要密钥

本 MCP 本身仅做本地代码生成，不需要访问远程服务。但若目标 API 要求鉴权，生成的代码中会预留 api_key / Authorization 等字段占位，请由使用者自行填入真实凭据，切勿在公共仓库明文提交。

典型用途

• 快速把内部 REST 接口接入 LLM 工具链。
• 为已有 OpenAPI 文档的第三方 API（如支付、天气、物流）生成 MCP 适配层。
• 在 CI 中批量刷新接口代码，保持与上游文档同步。

建议将生成的服务器代码放入独立目录，并在接入前运行一次本地烟雾测试，确认参数映射正确后再投入生产。