mcp-openapi

概述

@reapi/mcp-openapi 是一个模型上下文协议 (MCP) 服务器，它将 OpenAPI 规范与 LLM 驱动的开发环境连接起来。它从目录加载多个 OpenAPI 文件，解引用架构以提供完整上下文，并通过 MCP 暴露 API 操作。该服务器使 Cursor IDE 等工具能够实现智能代码补全、API 感知的代码生成和集成辅助功能。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• refresh-api-catalog

  Refresh the API catalog

  试试:Please refresh the API catalog试试:Reload the OpenAPI specifications
• get-api-catalog

  Get the complete API catalog with all specifications, operations, and schemas

  试试:Show me all available APIs in the catalog试试:List all API specifications and their endpoints
• search-api-operations

  Search for API operations across specifications

  试试:Find all endpoints related to pet management试试:Show me all endpoints that return paginated responses
• search-api-schemas

  Search for schemas across specifications

  试试:Find all schemas related to user objects试试:Show me all schemas that use the Address type
• load-api-operation-by-operationId

  Load an API operation by operation ID

  试试:Show me the details of the create pet API endpoint试试:Get the operation details for get-user-by-email
• load-api-operation-by-path-and-method

  Load an API operation by path and HTTP method

  试试:Show me the GET operation for /pets试试:What are the details for the POST operation to /users
• load-api-schema-by-schemaName

  Load an API schema by schema name

  试试:Show me the Pet schema details试试:Get the structure of the OrderItem schema

可对比工具

安装

npm install -g @reapi/mcp-openapi

{
  "mcpServers": {
    "@reapi/mcp-openapi": {
      "command": "npx",
      "args": ["-y", "@reapi/mcp-openapi@latest", "--dir", "./specs"],
      "env": {}
    }
  }
}

FAQ

支持哪些 OpenAPI 版本？

该服务器支持 JSON 和 YAML 格式的 OpenAPI 3.x 规范，文件扩展名为 .json、.yaml 或 .yml。

如何处理具有相似路径的多个 API 规范？

在 OpenAPI info 对象中使用 'x-spec-id' 字段为您的规范分配自定义 ID，这有助于区分相似资源。

Hacker News 讨论

开发者社区最近的相关讨论。

• Show HN: OpenAPI MCP Server – Make Cursor AI Understand Your API Specs▲ 2
  帖子 by peisong · 2025-03-30

mcp-openapi 对比