关于 OpenAPI MCP Server
这是一个将 OpenAPI YAML 规范中的操作转换为工具并执行相应 API 请求的 MCP 服务,面向希望通过生成的工具调用 API 的 Claude 用户。
主要功能
- 01解析 OpenAPI YAML 文件
- 02为每个 API 操作生成工具
- 03支持路径参数、查询参数和请求体
- 04发起 API 请求并返回响应
- 05集成 Claude Desktop
适用场景
- 01将 API 操作作为 Claude 工具使用
- 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
用法
-
将 OpenAPI YAML 文件放入项目目录,或通过环境变量提供文件路径。
-
设置环境变量(可选):
# Create a .env file
echo "DEBUG=true" > .env
echo "OPENAPI_FILE=./path/to/your/openapi.yaml" >> .env
- 在 Claude Desktop 中初始化服务:
npm run init
- 或手动运行服务:
npm start
配置
你可以使用环境变量配置服务:
DEBUG:设为true以启用调试日志(默认值:false)OPENAPI_FILE:OpenAPI YAML 文件的路径(默认值:./openapi.yaml)
工作原理
服务会读取你的 OpenAPI 规范文件,并:
- 提取所有路径和操作
- 为每个操作创建带有相应输入架构的工具
- Claude 调用工具时,服务会发起相应的 API 请求
- 将响应返回给 Claude 进行分析
示例
使用如下 OpenAPI 规范:
paths:
/users:
get:
operationId: listUsers
summary: List all users
...
Claude 可以调用 listUsers 工具,服务将代你向 /users 发起 GET 请求。
许可证
MIT
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。