Openapi MCP Server

🚀 OpenAPI MCP 服务器

OpenAPI MCP 服务器是一个适用于 Claude/Cursor 的 Model Context Protocol (MCP) 服务器，借助 oapis.org 实现对 OpenAPI 规范的搜索与探索，能为开发者在 API 探索和代码生成方面提供有力支持。

• 示例：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. 确定需要哪些端点，并检查它们的工作方式（再次用简单语言描述）。

⚠️ 重要提示

OpenAPI MCP 已经找到新主人并从 v1.2 迁移到了 v2，与之前的版本有所不同。您仍然可以访问任何 v2.0.0 之前版本及其 README，请参见此处。

OpenAPI MCP v2 是一个正在进行中的项目，专注于 API 的探索和提供上下文信息。它不允许直接执行端点作为工具，因为身份验证尚未通过 MCP 解决。然而，对于代码生成非常有用！

预期会有错误。欢迎贡献者 联系

✨ 主要特性

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

📦 安装指南

通过 Smithery 安装

要自动为 Claude Desktop 安装 openapi-mcp-server，请访问 Smithery：

npx -y @smithery/cli install @janwilmake/openapi-mcp-server --client claude

通过 npx 安装

运行并按照提示操作：

npx openapi-mcp-server@latest init

💻 使用示例

基础用法

安装完成后，您可以要求 Claude 执行以下操作：

"查找有关 Stripe API 的信息"
"解释如何使用 GitHub API 的仓库端点"

Claude 将会通过 MCP 服务器来：

1. 首先获取请求的 API 的概述。
2. 然后检索特定操作的详细信息。

🔧 技术细节

要求

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

📄 许可证

MIT