OpenAPI MCP 服务器
一个用于Claude/Cursor的模型上下文协议（MCP）服务器，可通过oapis.org搜索和探索OpenAPI规范。
- Demo: 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桌面和Cursor中测试
| 摘要 | 提问提示 |
|---|---|
| OpenAPI MCP服务器的基本理解 |  |
| MCP服务器的核心实现细节 |  |
| 如何扩展或贡献项目 |  |
安装
通过Smithery安装
通过Smithery自动安装openapi-mcp-server for Claude Desktop：
npx -y @smithery/cli install @janwilmake/openapi-mcp-server --client claude
通过npx安装
运行并遵循说明：
npx openapi-mcp-server@latest init
在Claude中的使用
安装后，您可以要求Claude：
- "查找有关Stripe API的信息"
- "解释如何使用GitHub API的仓库端点"
Claude将使用MCP服务器：
- 首先获取请求的API概览
- 然后根据需要检索特定操作详情
要求
- Node.js >= 16.17.0
- Claude桌面、Cursor或任何其他MCP客户端。
许可证
MIT