JO

janwilmake/openapi-mcp-server

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

905 stars 95 forks 质量 63 趋势 26MIT

让人工智能用简单语言应对复杂的OpenAPI。

概览

一个用于 Claude/光标的模型上下文协议(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.它确定你需要哪些端点,并检查它们具体如何工作(同样用简单语言) - 获取任何OpenAPI规范的概览 - 检索特定API操作的详细信息 - 支持JSON和YAML格式 - 已用Claude桌面和光标测试 对于其他客户端,请使用MCP网址:https://openapi-mcp.openapisearch.com/mcp

概述(AI 翻译)

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

MCP的工作原理是采用三步流程:

  1. 它会确定你需要的OpenAPI标识符
  2. 它要求用简单的语言总结
  3. 它确定你需要哪些端点,并检查它们具体如何工作(同样用简单的语言)

特色

  • 获取任何OpenAPI规范的概览
  • 检索特定API操作的详细信息
  • 支持 JSON 和 YAML 格式
  • 使用 Claude 桌面和光标测试

安装

对于其他客户端,请使用MCP网址:https://openapi-mcp.openapisearch.com/mcp

本地检测

先运行服务器

然后运行MCP检查器:

本页由 AI 翻译,技术细节请以原文为准。

README

OpenAPI MCP Server

A Model Context Protocol (MCP) server for Claude/Cursor that enables searching and exploring OpenAPI specifications through oapis.org.

The MCP works by applying a 3 step process:

  1. It figures out the openapi identifier you need
  2. It requests a summary of that in simple language
  3. It determines which endpoints you need, and checks out how exactly they work (again, in simple language)

Features

  • Get an overview of any OpenAPI specification
  • Retrieve details about specific API operations
  • Support for both JSON and YAML formats
  • Tested with Claude Desktop and Cursor

Installation

For other clients, use MCP URL: https://openapi-mcp.openapisearch.com/mcp

Local testing

First run the server

wrangler dev

Then run the mcp inspector:

npx @modelcontextprotocol/inspector
在 GitHub 查看完整 README

安装

npx @modelcontextprotocol/inspector
新手?先看 mcpskill.org 教程 →