Openapi

🚀 OpenAPI 到模型上下文协议（MCP）代理

OpenAPI-MCP 代理能够将 OpenAPI 规范转换为 MCP 工具，让 AI 代理无需自定义包装器就能访问外部 API！

🚀 快速开始

OpenAPI 到 Model Context Protocol (MCP) 代理服务器通过动态转换 OpenAPI 规范为标准化的 MCP 工具、资源和提示语，成功桥接了 AI 代理与外部 API 之间的差距。

✨ 主要特性

• 工具注册：将 OpenAPI 定义转换为 MCP 可用的工具，支持复杂的数据结构处理。
• 自动资源注册：从 OpenAPI 组件模式生成资源对象，并通过定义明确的 URI（例如 /resource/{name}）进行注册。
• 上下文提示语：基于 API 操作生成提示语，指导 LLM 使用相关端点，提升交互性。

序列图
    参与者 LLM 作为 Claude/GPT
    参与者 MCP 作为 OpenAPI-MCP 代理
    参与者 API 作为外部 API

    在 LLM 和 API 上标注：通信流程

    LLM->>MCP: 1. 初始化 (initialize)
    MCP-->>LLM: 元数据、工具、资源和提示语

    LLM->>MCP: 2. 请求工具列表 (tools_list)
    MCP-->>LLM: 工具的详细列表，包括资源和提示语

    LLM->>MCP: 3. 调用工具 (tools_call)

    条件分支：带有 OAuth2
        MCP->>API: 请求 OAuth2 访问令牌
        API-->>MCP: 接收访问令牌
    结束分支

    MCP->>API: 4. 执行 API 调用，格式正确
    API-->>MCP: 5. API 响应（JSON 格式）

    条件分支：类型转换
        MCP->>MCP: 6. 将参数转换为正确的数据类型
    结束分支

    MCP-->>LLM: 7. 格式化的 API 响应

    条件分支：干燥运行模式
        LLM->>MCP: 调用 dry_run=true
        MCP-->>LLM: 显示请求信息而无需执行调用
    结束分支

🤝 贡献指南

• fork 此仓库。
• 创建一个新的分支。
• 提交一个清晰描述更改的 pull request。

📄 许可证

MIT License

💡 使用建议

如果这个项目对你有帮助，请在 GitHub 上给它点个星星！