O

OpenAPI上下文搜索器

@janwilmake/openapi-mcp-server
0 Stars 75 次浏览 janwilmake 更新于 2026-08-23

一个模型上下文协议服务器,通过 oapis.org 允许搜索和探索 OpenAPI 规范,通过 Claude/Cursor 帮助用户理解 API。

该服务暂未提供标准配置,请参考 README 手动接入

服务介绍

OpenAPI MCP 服务器

一个用于 Claude/Cursor 的 Model Context Protocol (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 通过以下三步流程工作:

  1. 它会找出你需要的 OpenAPI 标识符
  2. 它会请求用简单的语言对该标识符进行总结
  3. 它会确定你需要哪些端点,并检查它们是如何工作的(同样使用简单的语言)

[!IMPORTANT]
OpenAPI MCP 已经找到了新主人,并且已经从 v1.2 迁移到了 v2,与之前的版本有所不同。你仍然可以访问 v2.0.0 之前的任何版本,其 README 文件位于这里

OpenAPI MCP v2 是一个正在进行中的项目,重点在于探索并提供有关 API 的上下文信息。它不允许直接作为工具执行这些端点,因为认证问题在 MCP 中尚未解决。然而,它非常适合代码生成!

预计会有错误。欢迎贡献者,私信

功能

  • 获取任意 OpenAPI 规范的概览
  • 检索特定 API 操作的详细信息
  • 支持 JSON 和 YAML 格式
  • 经过 Claude Desktop 和 Cursor 测试

安装

运行并按照说明操作:

npx openapi-mcp-server init

在 Claude 中的使用

安装完成后,你可以让 Claude 执行以下操作:

  • "查找关于 Stripe API 的信息"
  • "解释如何使用 GitHub API 的仓库端点"

Claude 将使用 MCP 服务器来:

  1. 首先获取所请求 API 的概览
  2. 然后根据需要检索特定的操作细节

要求

  • Node.js >= 16.17.0
  • Claude Desktop、Cursor 或其他任何 MCP 客户端。

许可证

MIT