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