MCP Catalogs
← 首页

mcp-openapi-schema-explorer

by kadykov·★ 71·综合分 46

一个通过 MCP 资源模板高效探索 OpenAPI/Swagger 规范的 MCP 服务器。

developer-toolsai-llmapi
12
Forks
2
活跃 Issue
本月
最近提交
2 天前
收录于

概述

MCP OpenAPI Schema Explorer 允许 MCP 客户端（如 Claude Desktop）访问 OpenAPI 规范，而无需将整个文件加载到上下文窗口中。它使用 MCP 资源模板暴露参数化的访问模式，用于 API 文档探索。该服务器支持 OpenAPI v3.0 和 Swagger v2.0 规范，可以从本地文件路径或远程 HTTP/HTTPS URL 加载，并自动将 v2.0 转换为 v3.0 格式。

试试问 AI

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

你:探索大型 API 文档，避免上下文窗口限制
你:以编程方式分析 API 端点和参数
你:基于 API 规范生成客户端代码或文档片段
你:这个服务器中的资源和工具有什么区别？
你:如何访问特定的 API 端点？

什么时候选它

当您需要在 AI 客户端中基于令牌高效访问 OpenAPI/Swagger 规范，而不将整个规范文件加载到上下文中时，请选择此方案。

什么时候不要选它

如果您需要对 API 规范进行写访问，或者需要直接 API 端点交互而不是文档探索，请不要选择此方案。

可对比工具

openapi-mcpswagger-mcpapi-docs-mcppostman-mcp

安装

安装

对于 Claude Desktop，将以下内容添加到您的 config.json 文件中：

{
  "mcpServers": {
    "我的 API 规范 (npx)": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-openapi-schema-explorer@latest",
        "<规范路径或URL>",
        "--output-format",
        "yaml"
      ],
      "env": {}
    }
  }
}

将 <规范路径或URL> 替换为您的 API 规范文件路径或 URL。

FAQ

这个服务器中的资源和工具有什么区别？
此服务器提供资源模板用于只读探索 API 规范，而不是可执行的工具。对于大型 API，这更节省令牌，因为它不需要预先枚举所有可能的端点。
如何访问特定的 API 端点？
使用 `openapi://paths/{path}/{method}` 等模板模式通过您的 MCP 客户端。客户端首先调用 `resources/templates/list` 发现可用模板，然后使用特定参数调用 `resources/read`。

mcp-openapi-schema-explorer 对比

mcp-openapi-schema-explorer vs ultimate_mcp_servermcp-openapi-schema-explorer vs mcp-server-chartmcp-openapi-schema-explorer vs everythingmcp-openapi-schema-explorer vs filesystemmcp-openapi-schema-explorer vs time
GitHub →

最后更新于 · 由 README + GitHub 公开数据自动生成。