基本能力
产品定位
OpenAPI MCP Server 是一个用于探索和理解 OpenAPI 规范的 MCP 服务器,特别适用于开发者在代码生成和 API 探索场景中使用。
核心功能
- 获取任何 OpenAPI 规范的概述
- 检索特定 API 操作的详细信息
- 支持 JSON 和 YAML 格式
- 与 Claude Desktop 和 Cursor 兼容
适用场景
- API 探索和理解
- 代码生成
- 开发者在需要快速了解和使用 OpenAPI 规范时的辅助工具
工具列表
- OpenAPISearch: 用于搜索 OpenAPI 规范的工具
- OAPIS: 提供 OpenAPI 规范的摘要和详细信息
常见问题解答
- OpenAPI MCP v2 是一个进行中的项目,可能存在一些 bug
- 目前不支持直接执行端点,因为认证问题尚未解决
- 欢迎贡献者参与,可以通过 DM 联系开发者
使用教程
使用依赖
- Node.js >= 16.17.0
- Claude Desktop, Cursor 或其他 MCP 客户端
安装教程
运行以下命令并按照指示操作:
bash
npx openapi-mcp-server@latest init
调试方式
安装完成后,可以在 Claude 中询问类似以下问题来进行调试:
- "Find information about the Stripe API"
- "Explain how to use the GitHub API's repository endpoints"
Claude 将使用 MCP 服务器首先获取请求的 API 的概述,然后根据需要检索特定的操作详细信息。