OpenAPI MCP 服务器

这是一个模型上下文协议 (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