OpenAPI搜索服务

一个用于Claude/Cursor的模型上下文协议(MCP)服务器,通过oapis.org实现OpenAPI规范的搜索和探索。

  • by hks-anakin
  • 本地部署
  • 更新于
在 GitHub 查看 hks-anakin/openapi-mcp-server

使用说明

OpenAPI MCP服务器

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个步骤来工作:

  1. 它计算出您需要的openapi标识符
  2. 它要求用简单的语言对此进行总结
  3. 它确定您需要哪些端点,并检查它们是如何工作的(同样,用简单的语言)

[!重要] OpenAPI MCP发现 新主人 并且已经从v1.2迁移到v2,其工作方式与之前的版本不同。您仍然可以访问v2.0.0之前的任何版本,其README是 这里

OpenAPI MCP v2是一个正在进行的工作,专注于探索和提供有关API的上下文。它 不 允许直接将端点作为工具执行,因为MCP还没有解决身份验证问题。然而,这对codegen来说很棒!

期待bug。向贡献者开放, 糖尿病

特性

  • 获取任何OpenAPI规范的概述
  • 检索有关特定API操作的详细信息
  • 支持JSON和YAML格式
  • 使用Claude Desktop和Cursor进行测试

安装

通过Smithery安装

通过以下方式自动安装Claude Desktop的openapi mcp服务器 史密瑟里:

npx -y @smithery/cli install @janwilmake/openapi-mcp-server --client claude

通过npx安装

运行并遵循说明:

npx openapi-mcp-server@latest init

Claude中的用法

安装后,您可以要求Claude:

  • “查找有关Stripe API的信息”
  • “解释如何使用GitHub API的存储库端点”

Claude将使用MCP服务器:

  1. 首先了解请求的API
  2. 然后根据需要检索特定的操作详细信息

需求

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

许可证

麻省理工学院