OpenAPI 模型上下文协议服务器

一个模型上下文协议（MCP）服务器，用于向大型语言模型（LLMs）如Claude公开OpenAPI模式信息。该服务器允许LLM探索和理解OpenAPI规范，通过一系列专用工具提供信息。

功能

• 加载任何指定的OpenAPI模式文件（JSON或YAML），可通过命令行参数指定
• 探索API路径、操作、参数和模式
• 查看请求和响应的详细模式
• 查找组件定义和示例
• 在整个API规范中进行搜索
• 以YAML格式获取响应，以便LLM更好地理解

使用方法

命令行

运行MCP服务器并指定特定的模式文件：

# 使用当前目录中的默认openapi.yaml文件
npx -y mcp-openapi-schema

# 使用相对路径的特定模式文件
npx -y mcp-openapi-schema ../petstore.json

# 使用绝对路径的特定模式文件
npx -y mcp-openapi-schema /absolute/path/to/api-spec.yaml

# 显示帮助信息
npx -y mcp-openapi-schema --help

Claude桌面集成

要将此MCP服务器与Claude Desktop一起使用，请编辑claude_desktop_config.json配置文件：

{
  "mcpServers": {
    "OpenAPI Schema": {
      "command": "npx",
      "args": ["-y", "mcp-openapi-schema", "/ABSOLUTE/PATH/TO/openapi.yaml"]
    }
  }
}

配置文件位置：

• macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: $env:AppData\Claude\claude_desktop_config.json

Claude Code集成

要将此MCP服务器与Claude Code CLI一起使用，请按照以下步骤操作：

1. 将OpenAPI Schema MCP服务器添加到Claude Code

   # 基本语法
   claude mcp add openapi-schema npx -y mcp-openapi-schema
   
   # 示例带有特定模式文件
   claude mcp add petstore-api npx -y mcp-openapi-schema ~/Projects/petstore.yaml
   

2. 验证注册的服务器

   # 列出所有配置的服务器
   claude mcp list
   
   # 获取您OpenAPI模式服务器的详细信息
   claude mcp get openapi-schema
   

3. 如有需要移除服务器

   claude mcp remove openapi-schema
   

4. 在Claude Code中使用工具

   配置完成后，您可以在Claude Code会话中通过询问有关OpenAPI模式的问题来调用此工具。

提示：

• 使用-s或--scope标志与project（默认）或global指定配置存储的位置
• 为不同的API添加多个MCP服务器，并使用不同名称

MCP工具

该服务器为LLM提供了以下工具以交互OpenAPI模式：

• list-endpoints: 列出所有API路径及其HTTP方法和摘要，以嵌套对象结构显示
• get-endpoint: 获取特定端点的详细信息，包括参数和响应
• get-request-body: 获取特定端点和方法的请求正文模式
• get-response-schema: 获取特定端点、方法和状态码的响应模式
• get-path-parameters: 获取特定路径的参数
• list-components: 列出所有组件（如schemas, parameters等）
• get-component: 获取特定组件的详细信息
• list-tags: 列出所有标签
• get-tag: 获取特定标签的详细信息

示例查询

列举所有端点

operation:
  name: list-endpoints
  parameters:
    - name: filter
      type: string
      description: 过滤器条件（可选）

获取特定端点的详细信息

operation:
  name: get-endpoint
  parameters:
    - name: endpointId
      type: string
      required: true
      description: 端点ID

获取请求正文模式

operation:
  name: get-request-body
  parameters:
    - name: requestId
      type: string
      required: true
      description: 请求ID

获取响应模式

operation:
  name: get-response-schema
  parameters:
    - name: responseId
      type: string
      required: true
      description: 响应ID

示例查询

curl -X GET "http://localhost:8080/api-docs"