OpenAPI MCP Server

OpenAPI MCP Server

允许AI使用简单语言处理复杂的开放API。

GitHub
Created Byjanwilmakejanwilmake

介绍

OpenAPI MCP 服务器是一个模型上下文协议(MCP)服务器，帮助 Claude/Cursor 理解并探索 OpenAPI 规范。通过 oapis.org，AI 可以用简单语言处理复杂的 API 文档。

核心功能

  • 获取 OpenAPI 规范概览
  • 检索特定 API 操作详情
  • 支持 JSON 和 YAML 格式
  • 与 Claude Desktop 和 Cursor 兼容

快速开始

安装

npx openapi-mcp-server init

根据安装向导完成配置。

在 Claude 中使用

安装完成后，可以让 Claude 执行以下类型的查询：

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

Claude 将通过 MCP 服务器：

  1. 获取请求 API 的概览
  2. 检索特定操作的详细信息

工作原理

MCP 通过三步流程工作：

  1. 确定所需的 OpenAPI 标识符
  2. 请求该标识符的概述
  3. 确定需要的端点，并查看其工作方式

重要说明

  • 此项目已迁移到 v2 版本，与之前版本有所不同
  • 不支持直接执行端点作为工具（身份验证问题尚未解决）
  • 非常适合代码生成
  • 项目仍在开发中，可能存在bug

系统要求

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

相关资源

许可证

MIT