OpenAPI

by janwilmake
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Supports converting OpenAPI specs to OpenAI tools format for integration with OpenAI models

  • Supports OpenAPI specifications defined in YAML format

OpenAPI MCP 服务器

Claude/Cursor 的模型上下文协议 (MCP) 服务器,支持通过 oapis.org 搜索和探索 OpenAPI 规范。

MCP 通过以下 3 个步骤进行工作:

  1. 它找出您需要的 openapi 标识符
  2. 它要求用简单的语言对此进行总结
  3. 它确定您需要哪些端点,并检查它们的具体工作方式(再次用简单的语言)

重要提示:OpenAPI MCP 已找到新所有者,并已从 v1.2 迁移至 v2,其工作方式与之前的版本不同。您仍然可以访问 v2.0.0 之前的任何版本,其 README 在此处

OpenAPI MCP v2 仍在开发中,专注于探索和提供 API 上下文。由于 MCP 的身份验证问题尚未解决,它支持直接将端点作为工具执行。不过,它非常适合代码生成!

预计会有 bug。欢迎贡献者、 DM

特征

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

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 openapi-mcp-server:

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 客户端。

执照

麻省理工学院

-
security - not tested
A
license - permissive license
-
quality - not tested

此工具会创建一个模型上下文协议 (MCP) 服务器,作为任何符合 OpenAPI v3.1 规范的 API 的代理。这允许您使用 Claude Desktop 轻松地与本地和远程服务器 API 进行交互。

  1. Features
    1. Installation
      1. Installing via Smithery
      2. Installing via npx
    2. Usage in Claude
      1. Requirements
        1. License
          ID: mk0h35rdwy