API 转换MCP 规范与示例

智能体广场支持将API转换为MCP，本文重点介绍API转换为MCP服务的的文件规范，并提供代码示例。

文件规范

API 文件需要符合以下规范。

代码示例

JSON 格式的 POST 请求示例如下。

Swagger

{
  "swagger": "2.0",
  "info": {
    "title": "weather",
    "version": "1.0.0"
  },
  "paths": {
    "/weather/{city}": {
      "get": {
        "operationId": "weather",
        "summary": "Check weather status。",
        "consumes": ["application/json"],
        "parameters": [
          {
            "name": "city",
            "description": "City",
            "type": "string",
            "in": "path",
            "required": true
          },
          {
            "name": "body",
            "in": "body",
            "schema": {
              "type": "object",
              "properties": {
                "date": {
                  "description": "Date",
                  "type": "string"
                }
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Weather status",
            "schema": {
              "type": "object",
              "properties": {
                "weather": {
                  "description": "Weather",
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}

OpenAPI 3.0

{
  "openapi": "3.0.1",
  "info": {
    "title": "weather",
    "version": "1.0.0"
  },
  "paths": {
    "/weather/{city}": {
      "get": {
        "operationId": "weather",
        "summary": "check the weather",
        "parameters": [
          {
            "name": "city",
            "description": "city",
            "type": "string",
            "schema": {
              "type": "string"
            },
            "in": "path",
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "date": {
                    "description": "Date",
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "weather",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "weather": {
                      "description": "weather",
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}