AgentKit
AgentKit
文档指南
请输入
- 文档首页
AgentKitAgentKit用户指南网关附录MCP 服务 API 文件规范与示例
复制全文
下载 pdfMCP 服务 API 文件规范与示例
文档反馈
问问助手AgentKit 支持将存量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"
}
}
}
}
}
}
}
}
}
}
}
最近更新时间：2026.09.20 19:18:57
这个页面对您有帮助吗？
有用
有用
无用
无用