OpenAPI MCP 服务器

这是一个为 Claude/Cursor 设计的模型上下文协议（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 通过以下三个步骤工作：

1. 确定你需要的 OpenAPI 标识符
2. 以简单语言请求该标识符的摘要
3. 确定你需要的端点，并检查它们具体如何工作（同样以简单语言）

[!IMPORTANT]
OpenAPI MCP 已经找到了新主人，并从 v1.2 迁移到了 v2，新版本与之前的版本工作方式不同。你仍然可以访问 v2.0.0 之前的任何版本，它们的 README 在这里。

OpenAPI MCP v2 仍在开发中，主要关注 API 的探索和提供上下文信息。它不允许直接作为工具执行端点，因为 MCP 尚未解决身份验证问题。然而，它非常适合代码生成！

请预期会有 bug。欢迎贡献者，私信

功能

• 获取任何 OpenAPI 规范的概览
• 检索特定 API 操作的详细信息
• 支持 JSON 和 YAML 格式
• 已在 Claude Desktop 和 Cursor 中测试

摘要	提示
OpenAPI MCP 服务器的基本理解
MCP 服务器的核心实现细节
如何扩展或贡献项目

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 openapi-mcp-server：

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 服务器：

1. 首先获取请求的 API 的概览
2. 然后根据需要检索特定操作的详细信息

要求

• Node.js >= 16.17.0
• Claude Desktop、Cursor 或任何其他 MCP 客户端。

许可证

MIT