OpenAPI Schema Explorer MCP 服务器

“OpenAPI Schema Explorer” MCP 服务器的作用是什么？

OpenAPI Schema Explorer MCP 服务器通过 MCP 资源，为 OpenAPI/Swagger 规范提供高效的 Token 访问，使客户端能够探索 API 模式。该服务器充当 AI 助手与外部 API 文档之间的桥梁，让工具和大语言模型（LLM）能够以编程方式查询、读取和分析 API 规范。通过将 OpenAPI/Swagger 规范作为结构化资源暴露，它简化了端点发现、参数检查和模式验证等任务，提升了团队集成或基于第三方 API 开发时的工作流效率。此服务器尤其适合希望自动化 API 文档分析、改进代码生成或以可扩展和标准化方式验证集成点的开发者和 AI 代理。

提示词列表

可用的仓库文件或文档中未提及明确的提示词模板。

资源列表

• OpenAPI/Swagger 规范
  将 OpenAPI 和 Swagger 规范文档作为结构化的 MCP 资源暴露，便于高效检索与探索。
• API 端点
  提供目标 OpenAPI/Swagger 规范下所有可用端点的资源视图，便于快速罗列与选择。
• 模式定义
  支持访问 API 规范中的模式定义和组件，助力验证与类型检查任务。

工具列表

在仓库的 server.py 或入口文件中未列出明确工具。

该 MCP 服务器的应用场景

• API 文档探索
  让 AI 助手和开发者可以以编程方式探索和导航 OpenAPI/Swagger 文档，提升入门和自动化效率。
• 端点发现
  快速识别并罗列目标 API 的可用端点，支持快速原型和集成。
• 模式验证
  支持自动化请求与响应模式的验证，确保兼容性并减少集成错误。
• 代码生成支持
  结构化访问规范细节，助力基于 OpenAPI 定义自动生成客户端代码或桩代码的工具。
• 自动化测试搭建
  通过暴露构建 API 请求所需的模式和参数，协助提取测试用例或模拟数据。

如何设置

Windsurf

1. 确保已安装所有前置条件（如 Node.js、Docker（如需））。
2. 定位 Windsurf 配置文件（通常为 windsurf.config.json）。
3. 使用如下 JSON 片段添加 OpenAPI Schema Explorer MCP 服务器：

   {
     "mcpServers": {
       "openapi-schema-explorer": {
         "command": "npx",
         "args": ["@kadykov/mcp-openapi-schema-explorer@latest"]
       }
     }
   }
   

4. 保存配置并重启 Windsurf。
5. 确认服务器已启动并可被客户端访问。

API 密钥安全管理：

{
  "mcpServers": {
    "openapi-schema-explorer": {
      "env": {
        "API_KEY": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
      },
      "inputs": {
        "api_key": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
      }
    }
  }
}

Claude

1. 安装必要依赖（Node.js 等）。
2. 编辑 Claude 平台的 MCP 配置文件。
3. 在 mcpServers 区块下插入以下 JSON：

   {
     "mcpServers": {
       "openapi-schema-explorer": {
         "command": "npx",
         "args": ["@kadykov/mcp-openapi-schema-explorer@latest"]
       }
     }
   }
   

4. 保存配置并重启 Claude。
5. 确认 MCP 服务器已出现在可用集成列表中。

API 密钥安全管理：

{
  "env": {
    "API_KEY": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  },
  "inputs": {
    "api_key": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  }
}

Cursor

1. 确认已安装 Node.js 及其他前置条件。
2. 打开 Cursor 平台的设置或配置文件。
3. 添加 MCP 服务器配置：

   {
     "mcpServers": {
       "openapi-schema-explorer": {
         "command": "npx",
         "args": ["@kadykov/mcp-openapi-schema-explorer@latest"]
       }
     }
   }
   

4. 保存并重新加载 Cursor。
5. 通过列出现有服务器检查集成情况。

API 密钥安全管理：

{
  "env": {
    "API_KEY": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  },
  "inputs": {
    "api_key": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  }
}

Cline

1. 确保所有前置条件（Node.js 等）已安装。
2. 找到并打开 Cline 配置文件。
3. 插入如下 JSON 以启用服务器：

   {
     "mcpServers": {
       "openapi-schema-explorer": {
         "command": "npx",
         "args": ["@kadykov/mcp-openapi-schema-explorer@latest"]
       }
     }
   }
   

4. 保存并重启 Cline。
5. 确认 MCP 服务器已出现在您的环境中。

API 密钥安全管理：

{
  "env": {
    "API_KEY": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  },
  "inputs": {
    "api_key": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  }
}

在流程中如何使用此 MCP

在 FlowHunt 中集成 MCP

如需将 MCP 服务器集成进 FlowHunt 工作流，首先在流程中添加 MCP 组件，并与您的 AI 代理连接：

点击 MCP 组件以打开配置面板。在系统 MCP 配置区，按如下 JSON 格式填写 MCP 服务器信息：

{
  "openapi-schema-explorer": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 代理即可作为工具使用该 MCP，并访问其全部功能。请记得将 “openapi-schema-explorer” 替换为实际 MCP 服务器名称，并将 URL 替换为您自己的 MCP 服务器地址。

总览

综上，OpenAPI Schema Explorer MCP 提供了实用的文档与配置说明，但缺乏明确的提示词与工具定义，限制了其开箱即用的智能代理泛用性。作为资源聚焦型 MCP 表现稳健，但若需高级应用仍有进一步开发或文档完善空间。
评分：6/10

MCP 评分