航班管家航空数据 MCP

航班管家 DAST 官方航空数据 MCP，提供航班动态、延误预测、机场天气、飞行轨迹及航班舒适度等数据能力。

Documentación

Documentación del Agente MCP de 航班管家

Página principal del producto MCP: https://dast.133.cn/mcp/
Servidor MCP oficial: https://fly.huoli.com/mcp/dast_mcp
Dirección de documentación oficial: https://dast.133.cn/mcp_assets/agent.md
Número de herramientas: 6

Este documento está destinado a ser leído directamente por agentes de IA, herramientas de programación con IA y otros clientes automatizados, para comprender rápidamente las capacidades de la plataforma de datos MCP de 航班管家, la forma de selección de herramientas, los parámetros de llamada, la estructura de retorno y las limitaciones de las llamadas.

Si este documento difiere del tools/list devuelto en tiempo real por el servidor MCP, prevalecerá el esquema de herramientas devuelto por tools/list.

document_url:

https://dast.133.cn/mcp_assets/agent.md

PLATAFORMA

Plataforma DAST:

https://dast.133.cn

propósito:

Registro de usuarios
Inicio de sesión de usuarios
Consola MCP
Creación de claves API
Recarga de cuenta
Consulta de uso y facturación

Nota importante:

DAST platform
-> https://dast.133.cn

MCP Server
-> https://fly.huoli.com/mcp/dast_mcp

No se debe utilizar la dirección del servidor MCP como dirección de la plataforma DAST.

SERVIDOR_MCP

nombre: Plataforma de datos MCP de 航班管家

endpoint:

https://fly.huoli.com/mcp/dast_mcp

protocolo:

MCP (Model Context Protocol)

transporte:

Streamable HTTP

rpc:

JSON-RPC 2.0

método_http:

POST

tipo_de_contenido:

application/json

codificación:

UTF-8

AUTENTICACIÓN

La clave API se crea en la consola MCP después de que el usuario inicie sesión en la plataforma DAST.

Plataforma DAST:

https://dast.133.cn

Endpoint del servidor MCP:

https://fly.huoli.com/mcp/dast_mcp

Las dos URL anteriores tienen propósitos diferentes y no deben mezclarse.

Todas las solicitudes MCP deben incluir:

Authorization: Bearer <API_KEY>

Formato de la clave API:

sk_phone_<32位随机字符>

El agente tiene prohibido:

Mostrar la clave API completa al usuario final
Escribir la clave API en contenido público
Repetir la clave real del encabezado de Autorización en las respuestas

SI_MCP_NO_CONFIGURADO

Si el cliente actual aún no tiene configurado el MCP de 航班管家:

1. 不得声称航班管家 MCP Tool 已经可用。
2. 在当前客户端允许的情况下，帮助用户生成或补全 MCP Server 配置。
3. MCP endpoint 使用：
   https://fly.huoli.com/mcp/dast_mcp
4. Authorization 保留为：
   Bearer <API_KEY>
5. 不得猜测、生成或暴露用户真实 API Key。
6. 如需 API Key，引导用户前往 DAST MCP 控制台获取或创建：
   https://dast.133.cn
7. 不得将 https://fly.huoli.com 用作注册、登录、API Key 创建、充值或控制台入口。
8. 配置完成后，重新加载或重新连接 MCP 客户端。
9. 调用 tools/list 验证 MCP Server 是否连接成功，并获取当前 Tool 定义。
10. 只有 tools/list 成功后，Agent 才可以认为航班管家 MCP Tool 已经可用。

objetivo_de_configuración:

MCP Server 已配置
-> 鉴权信息可用
-> 客户端已重新加载或重新连接
-> tools/list 调用成功
-> Tool 可用于正常用户请求

Si el entorno actual no permite que el agente modifique directamente la configuración de MCP:

向用户提供以下信息：
- 注册 / 登录 / 创建 API Key 的 DAST 平台：https://dast.133.cn
- 客户端配置使用的 MCP endpoint：https://fly.huoli.com/mcp/dast_mcp
- 鉴权占位符：Bearer <API_KEY>
- 当前客户端支持的 MCP 配置步骤

不得声称 MCP 配置已经完成。

SECUENCIA_DE_CONEXIÓN

Secuencia de conexión estándar:

1. initialize
2. notifications/initialized
3. tools/list
4. tools/call

initialize

Versión del protocolo de inicialización en este documento:

2025-03-26

La versión del protocolo realmente utilizada se regirá por el protocolVersion devuelto por initialize.

Ejemplo:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26",
    "capabilities": {},
    "clientInfo": {
      "name": "Your-Client",
      "version": "1.0.0"
    }
  }
}

Después de una inicialización exitosa, el cliente debe enviar:

{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}

Esta notificación no incluye id; después de enviarla, se procede a la fase normal de operación de herramientas.

tools/list

En la primera conexión o cuando se necesite confirmar las herramientas disponibles actualmente, se debe llamar a:

tools/list

Propósito:

Obtener las herramientas disponibles actualmente
Obtener el name de las herramientas
Obtener el description de las herramientas
Obtener el inputSchema más reciente

La plataforma ofrece actualmente 6 herramientas:

dast_flight_dynamic
dast_flight_route
dast_flight_happy
dast_delay_rate
dast_future_weather
dast_flight_path

Si las definiciones de parámetros de las herramientas en este documento difieren de los resultados devueltos por tools/list:

以 tools/list 返回结果为准。

ENRUTAMIENTO_DE_HERRAMIENTAS

El usuario pregunta por la dinámica en tiempo real o histórica de un vuelo específico:

使用 dast_flight_dynamic

El usuario pregunta qué vuelos hay entre dos aeropuertos en un día determinado:

使用 dast_flight_route

El usuario pregunta sobre comidas, WiFi, asientos, entretenimiento, equipaje o comodidad de un vuelo:

使用 dast_flight_happy

El usuario pregunta sobre la probabilidad de retraso o cancelación de un vuelo futuro:

使用 dast_delay_rate

El usuario pregunta sobre el clima futuro de un aeropuerto:

使用 dast_future_weather

El usuario pregunta sobre la posición actual, altitud, velocidad o trayectoria de vuelo:

使用 dast_flight_path

HERRAMIENTA: dast_flight_dynamic

propósito:

Consulta los datos dinámicos de un vuelo según el número de vuelo y la fecha especificada.

usar_cuando:

El usuario ya ha proporcionado un número de vuelo específico
Consultar el estado del vuelo
Consultar horas de salida y llegada planificadas
Consultar horas de salida y llegada estimadas
Consultar horas de salida y llegada reales
Consultar información dinámica del vuelo como terminales, etc.

parámetros_requeridos:

fnum

tipo: string
significado: número de vuelo
ejemplo: CA1831

date

tipo: string
formato: AAAA-MM-DD
significado: fecha local del aeropuerto de salida del vuelo (día natural local del aeropuerto), no la fecha en hora de Pekín ni la fecha de la ubicación del agente
ejemplo: 2026-08-10

ejemplo_de_argumentos:

{
  "fnum": "CA1831",
  "date": "2026-08-10"
}

tipo_de_datos_de_negocio:

array

regla_de_fecha_relativa:

如果用户使用“今天”“明天”“后天”等相对日期，
而 Agent 无法可靠确定该航班的出发机场及其当地日期，
应向用户确认具体日期或出发机场，
不得直接使用北京时间或 Agent 所在地日期。

precio:

0.5 CNY / 成功调用

HERRAMIENTA: dast_flight_route

propósito:

Consulta la lista de vuelos dinámicos entre aeropuertos según el aeropuerto de salida, el aeropuerto de llegada y la fecha.

usar_cuando:

El usuario no conoce el número de vuelo específico
El usuario necesita consultar vuelos entre dos aeropuertos
El usuario pregunta qué vuelos hay en una ruta en un día determinado

parámetros_requeridos:

depCode

tipo: string
significado: código IATA de tres letras del aeropuerto de salida
ejemplo: PEK

arrCode

tipo: string
significado: código IATA de tres letras del aeropuerto de llegada
ejemplo: SHA

date

tipo: string
formato: AAAA-MM-DD
significado: fecha local del aeropuerto de salida (día natural local del aeropuerto), no la fecha en hora de Pekín ni la fecha de la ubicación del agente
ejemplo: 2026-08-10

ejemplo_de_argumentos:

{
  "depCode": "PEK",
  "arrCode": "SHA",
  "date": "2026-08-10"
}

tipo_de_datos_de_negocio:

array

precio:

0.5 CNY / 成功调用

HERRAMIENTA: dast_flight_happy

propósito:

Consulta datos relacionados con la comodidad del vuelo.

información_disponible_puede_incluir:

Alimentación eléctrica
Espacio entre asientos
Comidas
Equipos de entretenimiento
WiFi
Peso del equipaje
Información de cabina, etc.

parámetros_requeridos:

date

tipo: string
formato: AAAA-MM-DD

modo_de_consulta:

Debe cumplir una de las dos condiciones siguientes:

OPCIÓN_A:

fnum

tipo: string
significado: número de vuelo
ejemplo: 9C8672

OPCIÓN_B:

depCode

tipo: string
significado: código IATA de tres letras del aeropuerto de salida
ejemplo: PVG

arrCode

tipo: string
significado: código IATA de tres letras del aeropuerto de llegada
ejemplo: SZX

parámetros_opcionales:

cabin

significado: clase de cabina
ejemplo: Y
comportamiento: si no se envía, se devuelven todas las clases disponibles

ejemplo_de_argumentos:

{
  "fnum": "9C8672",
  "date": "2026-08-15",
  "cabin": "Y"
}

tipo_de_datos_de_negocio:

array

precio:

0.2 CNY / 成功调用

HERRAMIENTA: dast_delay_rate

propósito:

Consulta la probabilidad de retraso y cancelación de vuelos futuros.

usar_cuando:

El usuario pregunta si un vuelo futuro es propenso a retrasos
El usuario pregunta sobre el riesgo de retraso
El usuario pregunta sobre el riesgo de cancelación
El usuario pregunta sobre el riesgo operativo de un vuelo futuro

parámetros_requeridos:

fnum

tipo: string
significado: número de vuelo

depCode

tipo: string
significado: código IATA de tres letras del aeropuerto de salida

arrCode

tipo: string
significado: código IATA de tres letras del aeropuerto de llegada

date

tipo: string
formato: AAAA-MM-DD

rango_de_fechas_soportado:

当日至未来 15 天

ejemplo_de_argumentos:

{
  "fnum": "CZ3000",
  "depCode": "PKX",
  "arrCode": "CAN",
  "date": "<YYYY-MM-DD>"
}

date debe estar dentro del rango desde hoy hasta los próximos 15 días.

salida_principal:

delayRate_30min
delayRate_60min
delayRate_90min
cancelRate

tipo_de_datos_de_negocio:

object

regla_de_interpretación:

Estos campos representan probabilidades de predicción, no eventos determinados.

Expresión recomendada:

该航班延误 30 分钟以上的预测概率为 12.2%。

Expresión no recomendada:

该航班会延误 30 分钟。

precio:

0.5 CNY / 成功调用

HERRAMIENTA: dast_future_weather

propósito:

Consulta el pronóstico del tiempo futuro de un aeropuerto.

usar_cuando:

El usuario pregunta sobre el clima de un aeropuerto
El usuario pregunta sobre cambios climáticos futuros en un aeropuerto
El usuario pregunta si el clima podría afectar las operaciones de vuelo

parámetros_requeridos:

airport

tipo: string
significado: código IATA de tres letras del aeropuerto
ejemplo: HFE

ejemplo_de_argumentos:

{
  "airport": "HFE"
}

rango_de_pronóstico:

未来 48 小时

resolución:

逐小时天气预报

información_meteorológica_puede_incluir:

Fenómeno meteorológico
Fuerza del viento
Velocidad del viento
Dirección del viento
Humedad relativa
Precipitación
Presión atmosférica
Cobertura de nubes
Temperatura

tipo_de_datos_de_negocio:

object

precio:

0.1 CNY / 成功调用

HERRAMIENTA: dast_flight_path

propósito:

Consulta la trayectoria de vuelo en tiempo real o histórica y el estado del vuelo.

usar_cuando:

El usuario pregunta dónde está volando actualmente el vuelo
El usuario pregunta sobre la trayectoria de vuelo
El usuario pregunta sobre la latitud y longitud actuales
El usuario pregunta sobre la altitud de vuelo
El usuario pregunta sobre la velocidad de vuelo
El usuario pregunta sobre la ruta de vuelo real

parámetros_requeridos:

fnum

tipo: string
significado: número de vuelo

depCode

tipo: string
significado: código IATA de tres letras del aeropuerto de salida

arrCode

tipo: string
significado: código IATA de tres letras del aeropuerto de llegada

date

tipo: string
formato: AAAA-MM-DD

ejemplo_de_argumentos:

{
  "fnum": "CZ3000",
  "depCode": "PEK",
  "arrCode": "CAN",
  "date": "2026-08-06"
}

la_salida_puede_incluir:

aircraftNo
flightNo
depAirport
arrAirport
curLat
curLon
curSpeed
curHeight
curAngle
aircraftType
aircraftAge
airlineCompany
flightState
depPlanTime
arrPlanTime
datos de la trayectoria de vuelo

tipo_de_datos_de_negocio:

object

precio:

0.1 CNY / 成功调用

REGLAS_DE_FECHA

Formato de fecha estándar:

YYYY-MM-DD

Para las siguientes herramientas:

dast_flight_dynamic
dast_flight_route

date representa la fecha local del aeropuerto de salida del vuelo (día natural local del aeropuerto), no la fecha en hora de Pekín ni la fecha de la ubicación del agente.

Reglas de interpretación de fechas:

查询“当地今天”
-> 使用出发机场当地的当前自然日

查询“当地明天”
-> 使用出发机场当地日期 + 1 day

查询“当地后天”
-> 使用出发机场当地日期 + 2 days

Si el usuario utiliza fechas relativas como "hoy", "mañana", "pasado mañana", el agente debe convertir según la fecha local del aeropuerto de salida del vuelo al que se refiere el usuario, y no debe sustituir directamente con la fecha en hora de Pekín o la fecha de la ubicación del agente.

Si el usuario proporciona explícitamente una fecha específica:

直接使用该 YYYY-MM-DD 日期，并按出发机场当地自然日理解。

Si no se puede determinar de manera segura la fecha local del aeropuerto a la que se refiere el usuario:

向用户询问，或根据当前上下文明确解析。

No se deben adivinar fechas inciertas.

REGLAS_DE_AEROPUERTO

Los parámetros de aeropuerto utilizan el código IATA de tres letras.

Ejemplos:

PEK = 北京首都国际机场
PKX = 北京大兴国际机场
SHA = 上海虹桥国际机场
PVG = 上海浦东国际机场
HFE = 合肥新桥国际机场
CAN = 广州白云国际机场

Si el usuario proporciona directamente el código de tres letras del aeropuerto:

直接使用该三字码。

guía_para_el_agente:

Si el usuario solo proporciona el nombre de la ciudad y esa ciudad tiene múltiples aeropuertos, el agente no debe elegir arbitrariamente un aeropuerto sin una base sólida.

Según la pregunta del usuario, se puede:

Determinar si es necesario cubrir múltiples aeropuertos
O confirmar con el usuario el aeropuerto específico

Ejemplos:

北京 != 始终等同于 PEK
上海 != 始终等同于 SHA

REGLAS_DE_NÚMERO_DE_VUELO

Ejemplos de números de vuelo:

CA1831
MU5105
CZ3000
9C8672

Si el usuario proporciona explícitamente un número de vuelo:

除非只是明显的格式规范化，否则不得擅自修改航班号。

LLAMADA_DE_HERRAMIENTA

Llamada estándar de herramienta MCP:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "<TOOL_NAME>",
    "arguments": {
      "<parameter>": "<value>"
    }
  }
}

Ejemplo:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dast_flight_dynamic",
    "arguments": {
      "fnum": "CA1831",
      "date": "2026-08-10"
    }
  }
}

RESPUESTA

Ejemplo de respuesta MCP:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"code\":0,\"msg\":\"success\",\"data\":...}"
      }
    ],
    "isError": false
  }
}

El JSON de negocio generalmente se encuentra en:

result.content[0].text

Esa cadena debe analizarse como JSON.

Ejemplo de respuesta de negocio analizada:

{
  "code": 0,
  "msg": "success",
  "data": {},
  "count": 1
}

reglas_de_respuesta:

code == 0
-> 调用成功

code != 0
-> 业务调用失败

msg
-> 状态或错误说明

data
-> 业务数据

count
-> 返回结果数量

No se debe juzgar el éxito de una llamada de negocio únicamente por el éxito de la solicitud HTTP.

También se debe verificar el campo de negocio code.

TIPOS_DE_DATOS_DE_NEGOCIO

dast_flight_dynamic -> array
dast_flight_route   -> array
dast_flight_happy   -> array
dast_delay_rate     -> object
dast_future_weather -> object
dast_flight_path    -> object

FACTURACIÓN

modelo_de_facturación:

账户余额预付费

regla_de_facturación:

Tool 调用成功
-> 扣减账户余额

Tool 调用失败
-> 不扣费

账户余额不足
-> Tool 调用失败

El agente debe:

Evitar llamadas repetidas innecesarias
Reutilizar preferentemente los datos ya obtenidos en la tarea actual cuando sea aplicable

ERRORES

PHONE_KEY_MISSING

code: 48001
meaning: 缺少 Authorization Bearer
action: 检查鉴权配置

PHONE_KEY_INVALID

code: 48002
meaning: API Key 无效或不存在
action: 检查或重新获取 API Key

PHONE_KEY_RATE_LIMITED

code: 48006
meaning: QPS 超限
action: 降低调用频率后重试

PARAM_INVALID

meaning: 请求参数无效
action: 检查 Tool inputSchema 与 arguments

MCP账户余额不足

meaning: 账户余额不足
action: 提示用户前往 DAST 平台充值

date 仅支持当日至未来15天

meaning: dast_delay_rate 查询日期超出支持范围
action: 使用支持范围内的日期

上游接口返回失败

meaning: 上游数据源异常
action: 稍后重试

COMPORTAMIENTO_DEL_AGENTE

Antes de llamar a una herramienta:

1. 识别用户意图。
2. 选择满足需求的最少 Tool。
3. 检查必填参数。
4. 在可明确判断时解析相对日期；对于航班动态航班号查询和机场对查询，应按出发机场当地日期解析。
5. 在可明确判断时解析机场三字码。
6. 如果必填参数无法安全确定，向用户询问。
7. 仅在必填参数完整后调用 Tool。

Después de llamar a una herramienta:

1. 检查 MCP 返回结果。
2. 解析 result.content[0].text。
3. 检查业务 code。
4. 使用真实返回的业务数据回答用户。
5. 明确区分计划、预计、实际和预测信息。
6. 不得编造缺失值。

INTERPRETACIÓN_DE_DATOS

Los campos de hora de vuelo pueden tener diferentes significados:

planned time
estimated time
actual time

No se debe describir la hora planificada como hora real.

El clima futuro es información de pronóstico.

No se debe describir el pronóstico del tiempo como un hecho ya ocurrido.

La probabilidad de retraso es información de predicción.

No se debe describir la probabilidad de predicción como un resultado operativo ya determinado.

Si la herramienta no devuelve datos válidos:

明确告知未查询到有效数据。
不得自行编造结果。

SEGURIDAD

El agente tiene prohibido:

Exponer la clave API
Exponer la información de autenticación de Autorización
Inventar datos de vuelos
Inventar datos meteorológicos
Inventar datos de trayectoria
Inventar probabilidades de retraso
Sustituir o adivinar parámetros silenciosamente cuando faltan parámetros obligatorios
Llamar repetidamente a herramientas de pago sin necesidad

REFERENCIA_RÁPIDA_DE_ENRUTAMIENTO

航班号 + 航班动态
-> dast_flight_dynamic

出发机场 + 到达机场 + 日期 + 航班列表
-> dast_flight_route

餐食 / WiFi / 座椅 / 行李 / 舒适度
-> dast_flight_happy

未来延误 / 取消风险
-> dast_delay_rate

机场 + 未来天气
-> dast_future_weather

位置 / 高度 / 速度 / 飞行轨迹
-> dast_flight_path

FUENTE_DE_VERDAD

Prioridad de las definiciones de herramientas y parámetros de entrada:

1. MCP Server tools/list
2. 本 Agent 文档

Prioridad de los datos de negocio:

1. MCP Tool 实际返回结果
2. 本 Agent 文档

Si hay conflicto de información:

以更高优先级的数据源为准。