实用工具来了，存量 OpenAPI 批量转化为 MCP Server

go install github.com/higress-group/openapi-to-mcpserver/cmd/openapi-to-mcp@latest

openapi-to-mcp --input path/to/openapi.json --output path/to/mcp-config.yaml

openapi-to-mcp --input petstore.json --output petstore-mcp.yaml --server-name petstore

{  "openapi": "3.0.0",  "info": {    "version": "1.0.0",    "title": "Swagger Petstore",    "description": "A sample API that uses a petstore as an example to demonstrate features in the OpenAPI 3.0 specification"  },  "servers": [    {      "url": "http://petstore.swagger.io/v1"    }  ],  "paths": {    "/pets": {      "get": {        "summary": "List all pets",        "operationId": "listPets",        "parameters": [          {            "name": "limit",            "in": "query",            "description": "How many items to return at one time (max 100)",            "required": false,            "schema": {              "type": "integer",              "format": "int32"            }          }        ],        "responses": {          "200": {            "description": "A paged array of pets",            "content": {              "application/json": {                "schema": {                  "type": "object",                  "properties": {                    "pets": {                      "type": "array",                      "items": {                        "type": "object",                        "properties": {                          "id": {                            "type": "integer",                            "description": "Unique identifier for the pet"                          },                          "name": {                            "type": "string",                            "description": "Name of the pet"                          },                          "tag": {                            "type": "string",                            "description": "Tag of the pet"                          }                        }                      }                    },                    "nextPage": {                      "type": "string",                      "description": "URL to get the next page of pets"                    }                  }                }              }            }          }        }      },      "post": {        "summary": "Create a pet",        "operationId": "createPets",        "requestBody": {          "description": "Pet to add to the store",          "required": true,          "content": {            "application/json": {              "schema": {                "type": "object",                "required": ["name"],                "properties": {                  "name": {                    "type": "string",                    "description": "Name of the pet"                  },                  "tag": {                    "type": "string",                    "description": "Tag of the pet"                  }                }              }            }          }        },        "responses": {          "201": {            "description": "Null response"          }        }      }    },    "/pets/{petId}": {      "get": {        "summary": "Info for a specific pet",        "operationId": "showPetById",        "parameters": [          {            "name": "petId",            "in": "path",            "required": true,            "description": "The id of the pet to retrieve",            "schema": {              "type": "string"            }          }        ],        "responses": {          "200": {            "description": "Expected response to a valid request",            "content": {              "application/json": {                "schema": {                  "type": "object",                  "properties": {                    "id": {                      "type": "integer",                      "description": "Unique identifier for the pet"                    },                    "name": {                      "type": "string",                      "description": "Name of the pet"                    },                    "tag": {                      "type": "string",                      "description": "Tag of the pet"                    }                  }                }              }            }          }        }      }    }  }}

openapi-to-mcp --input petstore.json --output petstore-mcp.yaml --server-name petstore

server:  name: petstoretools:  - name: showPetById    description: Info for a specific pet    args:      - name: petId        description: The id of the pet to retrieve        type: string        required: true        position: path    requestTemplate:      url: /pets/{petId}      method: GET    responseTemplate:      prependBody: |        # API Response Information
        Below is the response from an API call. To help you understand the data, I've provided:
        1. A detailed description of all fields in the response structure        2. The complete API response
        ## Response Structure
        > Content-Type: application/json
        - **id**: Unique identifier for the pet (Type: integer)        - **name**: Name of the pet (Type: string)        - **tag**: Tag of the pet (Type: string)
        ## Original Response
  - name: createPets    description: Create a pet    args:      - name: name        description: Name of the pet        type: string        required: true        position: body      - name: tag        description: Tag of the pet        type: string        position: body    requestTemplate:      url: /pets      method: POST      headers:        - key: Content-Type          value: application/json    responseTemplate: {}
  - name: listPets    description: List all pets    args:      - name: limit        description: How many items to return at one time (max 100)        type: integer        position: query    requestTemplate:      url: /pets      method: GET    responseTemplate:      prependBody: |        # API Response Information
        Below is the response from an API call. To help you understand the data, I've provided:
        1. A detailed description of all fields in the response structure        2. The complete API response
        ## Response Structure
        > Content-Type: application/json
        - **pets**:  (Type: array)          - **pets[].id**: Unique identifier for the pet (Type: integer)          - **pets[].name**: Name of the pet (Type: string)          - **pets[].tag**: Tag of the pet (Type: string)        - **nextPage**: URL to get the next page of pets (Type: string)
        ## Original Response

server:  name: "random-user-server"tools:- description: "Get random user information"  name: "get-user"  requestTemplate:    method: "GET"    url: "https://randomuser.me/api/"  responseTemplate:    body: |-      # User Information      {{- with (index .results 0) }}      - **Name**: {{.name.first}} {{.name.last}}      - **Email**: {{.email}}      - **Location**: {{.location.city}}, {{.location.country}}      - **Phone**: {{.phone}}      {{- end }}

"mcpServers": {  "postgres": {    "url": "http://your-higress-address/postgres/sse"  },  "rest-api": {    "url": "http://your-higress-address/user/sse"  }

server:  name: ecommerce-apitools:  - name: searchProducts    description: "Search for products in the e-commerce platform"    args:      - name: query        description: "Search query string"        type: string        required: true      - name: category        description: "Product category"        type: string        required: false      - name: limit        description: "Maximum number of results to return"        type: integer        default: 10    requestTemplate:      url: "https://api.example.com/products/search"      method: GET      argsToUrlParam: true    responseTemplate:      prependBody: |        # Search Results
        Below is the API response with these fields:
        - **success**: Boolean indicating if the request was successful        - **total**: Total number of matching products        - **page**: Current page number        - **pageSize**: Number of items per page        - **products**: Array of product objects with the following fields:          - **id**: Product unique identifier          - **name**: Product name          - **description**: Product description           - **price**: Product price          - **compareAtPrice**: Original price before discount          - **currency**: Currency code (e.g., USD, EUR)          - **availability**: Product availability status          - **metadata**: Technical metadata          - **attributes**: Product attributes          - **variants**: Product variations          - **images**: Product images          - **categories**: Categories the product belongs to          - **tags**: Product tags          - **brand**: Product brand information          - **shipping**: Shipping information          - **ratings**: Product ratings and reviews
        Original response:

server:  name: ecommerce-apitools:  - name: searchProducts    description: "搜索电商平台上的产品，返回匹配搜索条件的产品列表，包含产品基本信息、价格、库存状态、评分等"    args:      - name: query        description: "搜索关键词，可以是产品名称、品牌、型号或描述中的关键词"        type: string        required: true      - name: category        description: "产品类别，例如'electronics'、'clothing'、'home'等"        type: string        required: false      - name: limit        description: "返回结果数量，范围1-50"        type: integer        minimum: 1        maximum: 50        default: 10    requestTemplate:      url: "https://api.example.com/products/search"      method: GET      argsToUrlParam: true    responseTemplate:      body: |        # 产品搜索结果
        找到 {{.total}} 个匹配"{{.query}}"的产品，以下是最相关的 {{len .products}} 个结果：
        {{range $index, $product := .products}}        ## {{add $index 1}}. {{$product.name}}
        **价格**: {{if $product.onSale}}~~{{$product.compareAtPrice}} {{$product.currency}}~~ **{{$product.price}} {{$product.currency}}** (节省 {{percentage $product.compareAtPrice $product.price}}%){{else}}{{$product.price}} {{$product.currency}}{{end}}
        **品牌**: {{$product.brand.name}}
        **库存状态**: {{if eq $product.availability "in_stock"}}有货{{else if eq $product.availability "low_stock"}}库存不多{{else}}缺货{{end}}
        {{if gt (len $product.ratings.reviews) 0}}**评分**: {{$product.ratings.averageRating}}/5 ({{$product.ratings.reviewCount}}条评价){{end}}
        {{$product.description | truncate 200 "..."}}
        {{if gt (len $product.highlights) 0}}**产品特点**:        {{range $highlight := $product.highlights}}        - {{$highlight}}        {{end}}{{end}}
        {{end}}
        {{if gt .total (len .products)}}        还有更多结果未显示，可以通过调整搜索条件获取更精准的匹配。        {{end}}

# 产品搜索结果
找到 128 个匹配"智能手表"的产品，以下是最相关的 10 个结果：
## 1. TechFit Pro 智能手表
**价格**: ~~1299 CNY~~ **899 CNY** (节省 30.8%)
**品牌**: TechFit
**库存状态**: 有货
**评分**: 4.7/5 (342条评价)
TechFit Pro智能手表配备高清彩色触摸屏，支持心率监测、血氧检测、多种运动模式追踪和睡眠分析。防水设计，续航可达7天。
**产品特点**:- 高清AMOLED触摸屏- 7天超长续航- 心率和血氧监测- 30种运动模式- 5ATM防水
## 2. FitBit Versa 3
**价格**: 1499 CNY
**品牌**: FitBit
**库存状态**: 有货
**评分**: 4.5/5 (287条评价)
FitBit Versa 3智能手表集成GPS定位，支持24/7心率监测，内置语音助手，可接听电话，电池续航可达6天。
**产品特点**:- 内置GPS- 语音助手功能- 来电接听- 20+运动模式- 防水50米
## 3. Apple Watch Series 7
**价格**: 2999 CNY
**品牌**: Apple
**库存状态**: 库存不多
**评分**: 4.9/5 (1243条评价)
Apple Watch Series 7拥有更大的显示屏，更快的充电速度，IP6X防尘认证，游泳级防水，全天候血氧监测和心电图功能。
**产品特点**:- 视网膜级OLED显示屏- 快速充电- 心电图和血氧监测- 跌倒检测和紧急SOS- 支持Apple Pay
还有更多结果未显示，可以通过调整搜索条件获取更精准的匹配。