航班管家航空数据 MCP

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

Ver em 133.cnExperimente este MCPPatrocinado

Documentação

Documentação do MCP Agent 航班管家

Página inicial do produto MCP: https://dast.133.cn/mcp/
Servidor MCP oficial: https://fly.huoli.com/mcp/dast_mcp
Endereço da documentação oficial: https://dast.133.cn/mcp_assets/agent.md
Número de ferramentas: 6

Este documento é destinado à leitura direta por Agentes de IA, ferramentas de programação com IA e outros clientes automatizados, para compreender rapidamente as capacidades da plataforma de dados MCP do 航班管家, a forma de seleção de ferramentas, parâmetros de chamada, estrutura de retorno e limitações de chamada.

Se este documento divergir do tools/list retornado em tempo real pelo MCP Server, o Schema de Ferramentas retornado por tools/list prevalecerá.

document_url:

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

PLATAFORMA

Plataforma DAST:

https://dast.133.cn

finalidade:

Registro de usuário
Login de usuário
Console MCP
Criação de chave de API
Recarga de conta
Visualização de uso e faturamento

Observação importante:

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

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

O endereço do MCP Server não deve ser usado como endereço da plataforma DAST.

MCP_SERVER

nome: Plataforma de dados MCP 航班管家

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_conteúdo:

application/json

codificação:

UTF-8

AUTENTICAÇÃO

A chave de API é criada pelo usuário no console MCP após fazer login na plataforma DAST.

Plataforma DAST:

https://dast.133.cn

Endpoint do MCP Server:

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

As duas URLs acima têm finalidades diferentes e não devem ser misturadas.

Todas as solicitações MCP devem incluir:

Authorization: Bearer <API_KEY>

Formato da chave de API:

sk_phone_<32位随机字符>

O Agente está proibido de:

Exibir a chave de API completa ao usuário final
Escrever a chave de API em conteúdo público
Reproduzir a chave real do cabeçalho de Autorização nas respostas

SE_MCP_NAO_CONFIGURADO

Se o cliente atual ainda não tiver o MCP do 航班管家 configurado:

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_da_configuração:

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

Se o ambiente atual não permitir que o Agente modifique diretamente a configuração do MCP:

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

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

SEQUENCIA_DE_CONEXAO

Ordem padrão de conexão:

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

initialize

Versão do protocolo de inicialização neste documento:

2025-03-26

A versão do protocolo efetivamente usada será determinada pelo protocolVersion retornado por initialize.

Exemplo:

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

Após a inicialização bem-sucedida, o cliente deve enviar:

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

Essa notificação não contém id; após o envio, prossegue-se para a fase normal de operação de ferramentas.

tools/list

Na primeira integração ou quando for necessário confirmar as ferramentas disponíveis, deve-se chamar:

tools/list

Finalidade:

Obter as ferramentas atualmente disponíveis
Obter o name das ferramentas
Obter o description das ferramentas
Obter o inputSchema mais recente

A plataforma oferece atualmente 6 ferramentas:

dast_flight_dynamic
dast_flight_route
dast_flight_happy
dast_delay_rate
dast_future_weather
dast_flight_path

Se as definições de parâmetros das ferramentas neste documento diferirem do resultado retornado por tools/list:

以 tools/list 返回结果为准。

ROTEAMENTO_DE_FERRAMENTAS

O usuário pergunta sobre a dinâmica em tempo real ou histórica de um voo específico:

使用 dast_flight_dynamic

O usuário pergunta quais voos existem entre dois aeroportos em um determinado dia:

使用 dast_flight_route

O usuário pergunta sobre refeições, WiFi, assentos, entretenimento, bagagem ou conforto do voo:

使用 dast_flight_happy

O usuário pergunta sobre a probabilidade de atraso ou cancelamento de um voo futuro:

使用 dast_delay_rate

O usuário pergunta sobre o clima futuro de um aeroporto:

使用 dast_future_weather

O usuário pergunta sobre a posição atual, altitude, velocidade ou trajetória de voo:

使用 dast_flight_path

FERRAMENTA: dast_flight_dynamic

finalidade:

Consulta dados dinâmicos de voo por número do voo e data especificada.

usar_quando:

O usuário já forneceu o número específico do voo
Consultar o status do voo
Consultar horários planejados de partida e chegada
Consultar horários estimados de partida e chegada
Consultar horários reais de partida e chegada
Consultar informações dinâmicas do voo, como terminal, etc.

parâmetros_obrigatórios:

fnum

tipo: string
significado: número do voo
exemplo: CA1831

date

tipo: string
formato: AAAA-MM-DD
significado: data local do aeroporto de partida do voo (dia natural local do aeroporto), não é a data no horário de Pequim nem a data do local do Agente
exemplo: 2026-08-10

exemplo_de_argumentos:

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

tipo_de_dados_de_negócio:

array

regra_de_data_relativa:

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

preço:

0.5 CNY / 成功调用

FERRAMENTA: dast_flight_route

finalidade:

Consulta a lista dinâmica de voos entre aeroportos por aeroporto de partida, aeroporto de chegada e data.

usar_quando:

O usuário não sabe o número específico do voo
O usuário precisa consultar voos entre dois aeroportos
O usuário pergunta quais voos existem em uma rota em um determinado dia

parâmetros_obrigatórios:

depCode

tipo: string
significado: código IATA de três letras do aeroporto de partida
exemplo: PEK

arrCode

tipo: string
significado: código IATA de três letras do aeroporto de chegada
exemplo: SHA

date

tipo: string
formato: AAAA-MM-DD
significado: data local do aeroporto de partida (dia natural local do aeroporto), não é a data no horário de Pequim nem a data do local do Agente
exemplo: 2026-08-10

exemplo_de_argumentos:

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

tipo_de_dados_de_negócio:

array

preço:

0.5 CNY / 成功调用

FERRAMENTA: dast_flight_happy

finalidade:

Consulta dados relacionados ao conforto do voo.

informações_disponíveis_podem_incluir:

Energia
Espaçamento entre assentos
Refeições
Equipamentos de entretenimento
WiFi
Peso de bagagem
Classe, entre outras informações

parâmetros_obrigatórios:

date

tipo: string
formato: AAAA-MM-DD

modo_de_consulta:

Deve atender a uma das duas condições a seguir:

OPÇÃO_A:

fnum

tipo: string
significado: número do voo
exemplo: 9C8672

OPÇÃO_B:

depCode

tipo: string
significado: código IATA de três letras do aeroporto de partida
exemplo: PVG

arrCode

tipo: string
significado: código IATA de três letras do aeroporto de chegada
exemplo: SZX

parâmetros_opcionais:

cabin

significado: classe
exemplo: Y
comportamento: quando não informado, retorna todas as classes disponíveis

exemplo_de_argumentos:

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

tipo_de_dados_de_negócio:

array

preço:

0.2 CNY / 成功调用

FERRAMENTA: dast_delay_rate

finalidade:

Consulta a probabilidade de atraso e cancelamento de voos futuros.

usar_quando:

O usuário pergunta se um voo futuro tem probabilidade de atraso
O usuário pergunta sobre o risco de atraso
O usuário pergunta sobre o risco de cancelamento
O usuário pergunta sobre o risco operacional de um voo futuro

parâmetros_obrigatórios:

fnum

tipo: string
significado: número do voo

depCode

tipo: string
significado: código IATA de três letras do aeroporto de partida

arrCode

tipo: string
significado: código IATA de três letras do aeroporto de chegada

date

tipo: string
formato: AAAA-MM-DD

intervalo_de_datas_suportado:

当日至未来 15 天

exemplo_de_argumentos:

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

date deve estar dentro do intervalo entre a data atual e os próximos 15 dias.

principais_saídas:

delayRate_30min
delayRate_60min
delayRate_90min
cancelRate

tipo_de_dados_de_negócio:

object

regra_de_interpretação:

Esses campos representam probabilidades previstas, não eventos determinados.

Expressão recomendada:

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

Expressão não recomendada:

该航班会延误 30 分钟。

preço:

0.5 CNY / 成功调用

FERRAMENTA: dast_future_weather

finalidade:

Consulta a previsão do tempo futura para aeroportos.

usar_quando:

O usuário pergunta sobre o clima do aeroporto
O usuário pergunta sobre mudanças climáticas futuras no aeroporto
O usuário pergunta se o clima pode afetar as operações de voo

parâmetros_obrigatórios:

airport

tipo: string
significado: código IATA de três letras do aeroporto
exemplo: HFE

exemplo_de_argumentos:

{
  "airport": "HFE"
}

intervalo_de_previsão:

未来 48 小时

resolução:

逐小时天气预报

informações_climáticas_podem_incluir:

Fenômeno climático
Força do vento
Velocidade do vento
Direção do vento
Umidade relativa
Precipitação
Pressão atmosférica
Cobertura de nuvens
Temperatura

tipo_de_dados_de_negócio:

object

preço:

0.1 CNY / 成功调用

FERRAMENTA: dast_flight_path

finalidade:

Consulta a trajetória de voo em tempo real ou histórica e o status do voo.

usar_quando:

O usuário pergunta onde o voo está agora
O usuário pergunta sobre a trajetória de voo
O usuário pergunta sobre latitude e longitude atuais
O usuário pergunta sobre a altitude de voo
O usuário pergunta sobre a velocidade de voo
O usuário pergunta sobre a rota de voo real

parâmetros_obrigatórios:

fnum

tipo: string
significado: número do voo

depCode

tipo: string
significado: código IATA de três letras do aeroporto de partida

arrCode

tipo: string
significado: código IATA de três letras do aeroporto de chegada

date

tipo: string
formato: AAAA-MM-DD

exemplo_de_argumentos:

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

a_saída_pode_incluir:

aircraftNo
flightNo
depAirport
arrAirport
curLat
curLon
curSpeed
curHeight
curAngle
aircraftType
aircraftAge
airlineCompany
flightState
depPlanTime
arrPlanTime
dados da trajetória de voo

tipo_de_dados_de_negócio:

object

preço:

0.1 CNY / 成功调用

REGRAS_DE_DATA

Formato padrão de data:

YYYY-MM-DD

Para as seguintes ferramentas:

dast_flight_dynamic
dast_flight_route

date representa a data local do aeroporto de partida do voo (dia natural local do aeroporto), não é a data no horário de Pequim nem a data do local do Agente.

Regras de interpretação de data:

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

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

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

Se o usuário usar datas relativas como "hoje", "amanhã", "depois de amanhã", o Agente deve converter com base na data local do aeroporto de partida do voo ao qual o usuário se refere, e não substituir diretamente pela data no horário de Pequim ou pela data do local do Agente.

Se o usuário fornecer explicitamente uma data específica:

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

Se não for possível determinar com segurança a data local do aeroporto à qual o usuário se refere:

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

Não adivinhar datas incertas.

REGRAS_DE_AEROPORTO

Os parâmetros de aeroporto usam o código IATA de três letras.

Exemplos:

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

Se o usuário fornecer diretamente o código de três letras do aeroporto:

直接使用该三字码。

orientação_ao_agente:

Se o usuário fornecer apenas o nome da cidade e essa cidade tiver vários aeroportos, o Agente não deve escolher arbitrariamente um aeroporto sem fundamento.

Com base na pergunta do usuário, pode-se:

Avaliar se é necessário cobrir vários aeroportos
Ou confirmar com o usuário qual aeroporto específico

Exemplos:

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

REGRAS_DE_NUMERO_DE_VOO

Exemplos de números de voo:

CA1831
MU5105
CZ3000
9C8672

Se o usuário fornecer explicitamente o número do voo:

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

CHAMADA_DE_FERRAMENTA

Chamada padrão de ferramenta MCP:

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

Exemplo:

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

RESPOSTA

Exemplo de retorno do MCP:

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

O JSON de negócio geralmente está localizado em:

result.content[0].text

Essa string deve ser analisada como JSON.

Exemplo de retorno de negócio analisado:

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

regras_de_resposta:

code == 0
-> 调用成功

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

msg
-> 状态或错误说明

data
-> 业务数据

count
-> 返回结果数量

Não se deve julgar o sucesso da chamada de negócio apenas pelo sucesso da solicitação HTTP.

É obrigatório verificar também o campo de negócio code.

TIPOS_DE_DADOS_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

FATURAMENTO

modelo_de_faturamento:

账户余额预付费

regra_de_faturamento:

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

Tool 调用失败
-> 不扣费

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

O Agente deve:

Evitar chamadas repetidas desnecessárias
Reutilizar dados já obtidos na tarefa atual sempre que aplicável

ERROS

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: 稍后重试

COMPORTAMENTO_DO_AGENTE

Antes de chamar a ferramenta:

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

Depois de chamar a ferramenta:

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

INTERPRETACAO_DE_DADOS

Os campos de horário de voo podem ter significados diferentes:

planned time
estimated time
actual time

Não se deve descrever horários planejados como horários reais.

O clima futuro é informação de previsão.

Não se deve descrever a previsão do tempo como um fato já ocorrido.

A probabilidade de atraso é informação preditiva.

Não se deve descrever probabilidades previstas como resultados operacionais já determinados.

Se a ferramenta não retornar dados válidos:

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

SEGURANCA

O Agente está proibido de:

Expor a chave de API
Expor informações de autenticação de Autorização
Inventar dados de voo
Inventar dados climáticos
Inventar dados de trajetória
Inventar probabilidades de atraso
Substituir ou adivinhar silenciosamente parâmetros quando faltarem parâmetros obrigatórios
Chamar repetidamente ferramentas pagas sem necessidade

REFERENCIA_RAPIDA_DE_ROTEAMENTO

航班号 + 航班动态
-> dast_flight_dynamic

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

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

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

机场 + 未来天气
-> dast_future_weather

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

FONTE_DA_VERDADE

Prioridade das definições de ferramentas e parâmetros de entrada:

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

Prioridade dos dados de negócio:

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

Se houver conflito de informações:

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