OpenAPI MCP 服务器

这是一个 Model Context Protocol (MCP) 服务器，它可以读取 OpenAPI 规范文件，并将每个 API 操作作为工具提供给 Claude AI 使用。

功能

• 自动解析 OpenAPI YAML 文件
• 为每个 API 操作生成 MCP 工具
• 处理路径参数、查询参数和请求正文
• 当 Claude 使用这些工具时，实时调用相应 API
• 集成简便，可与 Claude Desktop 无缝对接

安装

# 克隆仓库
git clone https://github.com/yourusername/openapi-mcp-server.git
cd openapi-mcp-server

# 安装依赖项
npm install

使用方法

1. 将你的 OpenAPI YAML 文件放在项目目录中，或通过环境变量提供其路径。

2. 配置环境变量（可选）：

# 创建 .env 文件
echo "DEBUG=true" > .env
echo "OPENAPI_FILE=./path/to/your/openapi.yaml" >> .env

3. 使用 Claude Desktop 初始化服务器：

npm run init

4. 或手动运行服务器：

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: 列出所有用户
      ...

Claude 可以调用 listUsers 工具，服务器将代为发送对 /users 的 GET 请求。

许可证

MIT