OpenAPI Schema Explorer

关于 OpenAPI Schema Explorer

OpenAPI Schema Explorer 是一款基于 MCP 协议的轻量工具，专为需要快速查阅 OpenAPI / Swagger 规范文档的客户端开发者打造。它通过 MCP 资源接口，将大型 API 文档拆解为按路径（Path）、标签（Tag）或端点组织的可索引条目，显著降低单次请求的 token 消耗。

它能做什么

• 按需加载接口详情：仅返回当前所需的端点、方法、参数与响应结构。
• 支持结构化搜索：在路径、操作 ID 或摘要中快速定位目标接口。
• 提供 schema 摘要视图：展示字段类型、是否必填、示例值，便于生成请求样例。
• 兼容 OpenAPI 3.x 与 Swagger 2.0 规范。

使用提示

• 接入方式：通过 MCP 客户端连接，将其注册为 resources 提供者即可调用。
• 鉴权情况：默认无需密钥；若所托管的 OpenAPI 文档来自私有网关或企业内网，则需在后端自行配置访问令牌，本 MCP 本身不颁发或存储 token。
• 适用场景：代码助手中生成接口调用代码、自动化测试用例编写、API 探索式问答。

如需进一步了解 MCP 资源协议规范，可参考 Model Context Protocol 官方文档。