mcpField
O
OpenAPI MCP Server

OpenAPI MCP Server

本地服务
openapisearch.com开发工具183 周前更新

关于 OpenAPI MCP Server

这是一个将 OpenAPI YAML 规范中的操作转换为工具并执行相应 API 请求的 MCP 服务,面向希望通过生成的工具调用 API 的 Claude 用户。

主要功能

  1. 01解析 OpenAPI YAML 文件
  2. 02为每个 API 操作生成工具
  3. 03支持路径参数、查询参数和请求体
  4. 04发起 API 请求并返回响应
  5. 05集成 Claude Desktop

适用场景

  1. 01将 API 操作作为 Claude 工具使用
  2. 02查询由 OpenAPI YAML 文件描述的 API

MCP 相关

服务将 OpenAPI 操作作为 MCP 工具提供;Claude 调用工具时,服务会发起对应的 API 请求。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

OpenAPI MCP 服务

这是一个模型上下文协议(MCP)服务,可读取 OpenAPI 规范文件,并将每个 API 操作公开为供 Claude AI 使用的工具。

功能

  • 自动解析 OpenAPI YAML 文件
  • 为每个 API 操作生成 MCP 工具
  • 处理路径参数、查询参数和请求正文
  • Claude 使用工具时发起实时 API 调用
  • 轻松集成 Claude Desktop

安装

# Clone the repository
git clone https://github.com/yourusername/openapi-mcp-server.git
cd openapi-mcp-server

# Install dependencies
npm install

用法

  1. 将 OpenAPI YAML 文件放入项目目录,或通过环境变量提供文件路径。

  2. 设置环境变量(可选):

# Create a .env file
echo "DEBUG=true" > .env
echo "OPENAPI_FILE=./path/to/your/openapi.yaml" >> .env
  1. 在 Claude Desktop 中初始化服务:
npm run init
  1. 或手动运行服务:
npm start

配置

你可以使用环境变量配置服务:

  • DEBUG:设为 true 以启用调试日志(默认值:false)
  • OPENAPI_FILE:OpenAPI YAML 文件的路径(默认值:./openapi.yaml)

工作原理

服务会读取你的 OpenAPI 规范文件,并:

  1. 提取所有路径和操作
  2. 为每个操作创建带有相应输入架构的工具
  3. Claude 调用工具时,服务会发起相应的 API 请求
  4. 将响应返回给 Claude 进行分析

示例

使用如下 OpenAPI 规范:

paths:
  /users:
    get:
      operationId: listUsers
      summary: List all users
      ...

Claude 可以调用 listUsers 工具,服务将代你向 /users 发起 GET 请求。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。