OpenAPI上下文搜索器
一个模型上下文协议服务器,通过 oapis.org 允许搜索和探索 OpenAPI 规范,通过 Claude/Cursor 帮助用户理解 API。
服务介绍
OpenAPI MCP 服务器
一个用于 Claude/Cursor 的 Model Context Protocol (MCP) 服务器,通过 oapis.org 搜索和探索 OpenAPI 规范。
- 演示:https://x.com/janwilmake/status/1903497808134496583
- HN 讨论:https://news.ycombinator.com/item?id=43447278
- OpenAPISearch:https://github.com/janwilmake/openapisearch
- OAPIS:https://github.com/janwilmake/oapis
MCP 通过以下三步流程工作:
- 它会找出你需要的 OpenAPI 标识符
- 它会请求用简单的语言对该标识符进行总结
- 它会确定你需要哪些端点,并检查它们是如何工作的(同样使用简单的语言)
[!IMPORTANT]
OpenAPI MCP 已经找到了新主人,并且已经从 v1.2 迁移到了 v2,与之前的版本有所不同。你仍然可以访问 v2.0.0 之前的任何版本,其 README 文件位于这里OpenAPI MCP v2 是一个正在进行中的项目,重点在于探索并提供有关 API 的上下文信息。它不允许直接作为工具执行这些端点,因为认证问题在 MCP 中尚未解决。然而,它非常适合代码生成!
预计会有错误。欢迎贡献者,私信
功能
- 获取任意 OpenAPI 规范的概览
- 检索特定 API 操作的详细信息
- 支持 JSON 和 YAML 格式
- 经过 Claude Desktop 和 Cursor 测试
安装
运行并按照说明操作:
npx openapi-mcp-server init
在 Claude 中的使用
安装完成后,你可以让 Claude 执行以下操作:
- "查找关于 Stripe API 的信息"
- "解释如何使用 GitHub API 的仓库端点"
Claude 将使用 MCP 服务器来:
- 首先获取所请求 API 的概览
- 然后根据需要检索特定的操作细节
要求
- Node.js >= 16.17.0
- Claude Desktop、Cursor 或其他任何 MCP 客户端。
许可证
MIT