关于 OpenAPI MCP Server
OpenAPI MCP Server 是一个 MCP 服务，用于在 Claude、Cursor 等客户端中搜索和浏览 OpenAPI 规范。它通过 oapis.org 获取规范内容，并以简明语言呈现，适合需要快速理解复杂 API 的开发者。
主要功能
- 01搜索 OpenAPI 规范
- 02获取规范的概要说明
- 03查看特定 API 操作的详细信息
- 04支持 JSON 与 YAML 格式
适用场景
- 01在编码时快速了解第三方 API 的结构
- 02查找某个 API 中用于特定任务的端点及其用法
MCP 相关
该项目是一个 MCP 服务，向 Claude Desktop、Cursor 等 MCP 客户端提供 OpenAPI 规范的查询与浏览能力。远程服务地址为 https://openapi-mcp.openapisearch.com/mcp。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
服务地址
https://openapi-mcp.openapisearch.com/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http openapi https://openapi-mcp.openapisearch.com/mcpCursor.cursor/mcp.json
{"mcpServers":{"openapi":{"type":"http","url":"https://openapi-mcp.openapisearch.com/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"openapi":{"type":"http","url":"https://openapi-mcp.openapisearch.com/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"openapi":{"type":"http","url":"https://openapi-mcp.openapisearch.com/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"openapi":{"serverUrl":"https://openapi-mcp.openapisearch.com/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
2| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | API 标识符，可以是来自 openapisearch.com 的已知 ID，也可以是指向原始 OpenAPI 文件的 URL |
详细介绍
OpenAPI MCP Server
一个适用于 Claude/Cursor 的模型上下文协议（MCP）服务，可通过 oapis.org 搜索和探索 OpenAPI 规范。
- 演示：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 采用 3 步流程：
- 确定你需要的 OpenAPI 标识符
- 请求以简单语言提供相关摘要
- 确定你需要的端点，并查看其具体工作方式（同样使用简单语言）
功能
- 获取任意 OpenAPI 规范的概览
- 获取特定 API 操作的详细信息
- 支持 JSON 和 YAML 格式
- 已通过 Claude Desktop 和 Cursor 测试
安装
其他客户端请使用 MCP URL：https://openapi-mcp.openapisearch.com/mcp
本地测试
首先运行服务
wrangler dev
然后运行 MCP 检查器：
npx @modelcontextprotocol/inspector
评论
支持 Markdown
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。