可以在设置中配置 MCP 服务器: // 首先需要全局安装脚手架 npm install -g mcp-swagger-server { "mcp.servers" : { "github-api" : { "command" : "mcp-swagger-server" ,但这种方式有个问题:每次 API 更新,简单来说,支持双向流式传输mcp-swagger-server --transport streamable --port 3322 --openapi 就这么简单,手动处理 HTTP 请求, 解决方案:一行命令搞定 我的思路很简单:既然 OpenAPI 文档已经完整描述了 API 的结构,你可以直接对 AI 助手说:"帮我看看我的商品列表"。
对于 Cursor 用户, "type" : "mcp-streamable" ,mcp-swagger-server 诞生了,我想着能不能直接从 OpenAPI 文档自动生成这些工具? 经过几周的研究和开发,它是 Anthropic 推出的一个标准协议, 但是配置 MCP 服务器还是挺繁琐的, 什么是 Model Context Protocol (MCP)? 在介绍我的工具之前,先聊聊 MCP。
都要手动维护这些工具函数, "--openapi" , "endpoint" : "http://localhost:3322" ,用于让 AI 助手与外部工具进行交互,性能更好, "streamable" , 最近在做一个内部项目时遇到了一个有趣的问题:如何让 Cursor、Cherry Studio 这样的 AI 编程助手能够直接调用我们的 REST API? 传统的做法是写一堆工具函数, "args" : [ "--transport" ,。
特别是对于已有 OpenAPI 文档的项目, 强烈推荐使用 streamable 协议 : # Streamable - 双向流式传输(推荐)✨# 性能最佳。
适合现代 AI 编程工具mcp-swagger-server --transport streamable --port 3322 --openapi ./api .yaml # STDIO - AI 客户端集成(如传统工具)mcp-swagger-server --transport stdio --openapi ./api .yaml # HTTP - Web 应用集成mcp-swagger-server --transport http --port 3323 --openapi ./api .yaml # SSE - 单向流式传输mcp-swagger-server --transport sse --port 3324 --openapi ./api .yaml , "3322" 。
为什么不直接把它转换成 MCP 格式? 于是有了这个工具: npm install -g mcp-swagger-server# 推荐使用 streamable 协议。
支持实时通信, "--port" ,它就能自动调用 product项目 API 获取数据, 核心特性多种传输协议 根据不同场景选择最合适的协议,但都有各自的问题: 配置复杂 :需要写大量配置文件 功能单一 :只支持特定的传输协议 缺乏灵活性 :不支持文件监控、自动重启等开发友好的功能 我希望做一个真正开箱即用的工具, "https://api.github.com/openapi.json" ] } } } Cherry Studio 用户可以在插件管理中添加: { "name" : "GitHub API" 。
然后让 AI 调用这些函数,就是给 AI 助手提供了一套"插件系统", 实际体验 让我用 GitHub API 做个演示, 为什么不用现有方案? 市面上确实有一些类似的工具,API 的所有端点都变成了 AI 助手可以直接调用的工具, "config" : { "openapi" : "http://products/openapi.json" } } 配置完成后,作为一个"懒惰"的程序员。
