Integración del Protocolo de contexto del modelo (MCP)

La API de Travel Impact Model (TIM) admite el Protocolo de contexto del modelo (MCP), un estándar abierto diseñado para que los agentes de IA y los modelos de lenguaje grandes (LLM) interactúen con APIs y herramientas. Con el extremo de MCP, los agentes de IA pueden descubrir y usar de forma dinámica las capacidades de la API de TIM para calcular las emisiones de los vuelos.

Para obtener más información sobre el protocolo, consulta la Especificación del Protocolo de contexto del modelo.

Extremo

El extremo de MCP para la API de Travel Impact Model es el siguiente:

https://travelimpactmodel.googleapis.com/mcp

Todas las interacciones de MCP se realizan mediante el envío de solicitudes POST de JSON-RPC 2.0 a este extremo.

Autenticación

El extremo de MCP usa los mismos métodos de autenticación que la API estándar de Travel Impact Model. Debes proporcionar una clave de API válida de tu proyecto de Google Cloud y asegurarte de que la "API de Travel Impact Model" esté habilitada.

Métodos principales de MCP

Las interacciones con el extremo de MCP usan principalmente dos métodos:

  • tools/list: Descubre las herramientas disponibles, sus descripciones y sus esquemas JSON de entrada y salida.
  • tools/call: Ejecuta una herramienta específica con los argumentos proporcionados.

Herramientas disponibles

Las siguientes funcionalidades se exponen como herramientas:

  • compute_flight_emissions: Recupera las emisiones detalladas de vuelos específicos próximos.
  • compute_typical_flight_emissions: Recupera las emisiones típicas entre pares de aeropuertos, sin necesidad de detalles específicos del vuelo.
  • compute_scope3_flight_emissions: Recupera las emisiones de vuelos históricos, adecuadas para los informes de Alcance 3.

Los esquemas exactos para las entradas y salidas se proporcionan en la respuesta tools/list.

Integración con agentes de IA

Configura las aplicaciones de IA populares con estas instrucciones. Reemplaza YOUR_API_KEY por tu clave de API de Travel Impact Model.

Gemini CLI

Para configurar Gemini CLI, sigue estos pasos:

  1. Crea un archivo de extensión en ~/.gemini/extensions/travel-impact-model/gemini-extension.json.

  2. Guarda el siguiente contenido en el archivo:

    {
  "name": "travel-impact-model",
  "version": "3.0.0",
  "mcpServers": {
    "travel-impact-model": {
      "httpUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. Para iniciar Gemini CLI, ejecuta gemini en tu terminal.

  4. Ejecuta /mcp list para verificar que el servidor travel-impact-model esté configurado y que sus herramientas estén disponibles.

Antigravity

Para configurar Antigravity para que use el servidor de MCP , haz lo siguiente:

  1. En Antigravity, haz clic en el menú Opciones adicionales en el panel Agent > Servidores de MCP > Administrar servidores de MCP.

  2. En la parte superior del panel Administrar servidores de MCP que se abre, haz clic en Ver configuración sin procesar para editar el archivo mcp_config.json:

    {
  "mcpServers": {
    "TravelImpactModel": {
      "serverUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. Regresa a Administrar servidores de MCP y haz clic en Actualizar.

Ejemplos de interacciones

Una vez configurado, puedes interactuar con la API de TIM a través de tu agente de IA con lenguaje natural.

Usuario: ¿Cuáles son las emisiones del vuelo LX 52 de Zúrich a Boston?

Agente: Las emisiones de carbono proyectadas por pasajero para el vuelo LX 52 de Swiss International Air Lines de Zúrich (ZRH) a Boston (BOS) para hoy, 25 de marzo de 2026, son las siguientes:

  • Económico: 354.10 kg de CO2e
  • Clase turista premium: 531.14 kg de CO2e
  • Ejecutivo: 1,416.38 kg de CO2e
  • Primeros: 1,770.48 kg de CO2e

Este vuelo tiene un impacto moderado proyectado de las estelas.

Usuario: ¿Cuáles son las emisiones típicas de Zúrich a Boston?

Agente: Las emisiones de carbono típicas por pasajero para un vuelo de Zúrich (ZRH) a Boston (BOS) son las siguientes:

  • Económico: 415.41 kg de CO2e
  • Clase turista premium: 582.00 kg de CO2e
  • Ejecutivo: 1,473.95 kg de CO2e
  • Primeros: 1,817.35 kg de CO2e