یکپارچه‌سازی پروتکل زمینه مدل (MCP)

رابط برنامه‌نویسی کاربردی مدل تأثیر سفر (TIM) از پروتکل زمینه مدل (MCP) پشتیبانی می‌کند، یک استاندارد باز که برای عامل‌های هوش مصنوعی و مدل‌های زبان بزرگ (LLM) طراحی شده است تا با APIها و ابزارها تعامل داشته باشند. با استفاده از نقطه پایانی MCP، عامل‌های هوش مصنوعی می‌توانند به صورت پویا قابلیت‌های TIM API را برای محاسبه انتشار گازهای گلخانه‌ای پرواز کشف و استفاده کنند.

برای اطلاعات بیشتر در مورد پروتکل، به مشخصات پروتکل Model Context مراجعه کنید.

نقطه پایانی

نقطه پایانی MCP برای API مدل تأثیر سفر عبارت است از:

https://travelimpactmodel.googleapis.com/mcp

تمام تعاملات MCP با ارسال درخواست‌های JSON-RPC 2.0 POST به این نقطه پایانی انجام می‌شود.

احراز هویت

نقطه پایانی MCP از همان روش‌های احراز هویت API استاندارد Travel Impact Model استفاده می‌کند. شما باید یک کلید API معتبر از پروژه Google Cloud خود ارائه دهید و مطمئن شوید که "Travel Impact Model API" فعال است.

روش‌های اصلی MCP

تعاملات با نقطه پایانی MCP عمدتاً از دو روش استفاده می‌کنند:

• tools/list : ابزارهای موجود، توضیحات آنها و طرح‌های JSON ورودی/خروجی آنها را کشف می‌کند.
• tools/call : یک ابزار خاص را با آرگومان‌های داده شده اجرا می‌کند.

ابزارهای موجود

قابلیت‌های زیر به عنوان ابزار در معرض دید قرار می‌گیرند:

• compute_flight_emissions : میزان انتشار دقیق گازهای گلخانه‌ای را برای پروازهای خاص آینده بازیابی می‌کند.
• compute_typical_flight_emissions : میزان انتشار معمول بین جفت‌های فرودگاه را بدون نیاز به جزئیات خاص پرواز، بازیابی می‌کند.
• compute_scope3_flight_emissions : میزان انتشار گازهای گلخانه‌ای پروازهای تاریخی را بازیابی می‌کند، که برای گزارش‌دهی Scope 3 مناسب است.

طرحواره‌های دقیق برای ورودی‌ها و خروجی‌ها در پاسخ tools/list ارائه شده است.

با نمایندگان هوش مصنوعی ادغام شوید

با استفاده از این دستورالعمل‌ها، برنامه‌های محبوب هوش مصنوعی را پیکربندی کنید. YOUR_API_KEY را با کلید API مدل Travel Impact خود جایگزین کنید.

رابط خط فرمان جمینی

برای پیکربندی Gemini CLI ، مراحل زیر را دنبال کنید:

1. یک فایل افزونه در ~/.gemini/extensions/travel-impact-model/gemini-extension.json ایجاد کنید.

2. محتوای زیر را در فایل ذخیره کنید:

   {
     "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. با اجرای gemini در ترمینال خود، رابط خط فرمان Gemini را اجرا کنید.

4. برای تأیید پیکربندی سرور travel-impact-model و در دسترس بودن ابزارهای آن، /mcp list اجرا کنید.

ضد جاذبه

برای پیکربندی Antigravity جهت استفاده از سرور MCP:

1. در Antigravity، روی منوی Additional options در پنل Agent > MCP Servers > Manage MCP Servers کلیک کنید.

2. در بالای پنجره مدیریت سرورهای MCP که باز می‌شود، روی «مشاهده پیکربندی خام» کلیک کنید تا فایل mcp_config.json را ویرایش کنید:

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

3. به مدیریت سرورهای MCP برگردید و روی Refresh کلیک کنید.

مثال‌هایی از تعاملات

پس از پیکربندی، می‌توانید از طریق عامل هوش مصنوعی خود با استفاده از زبان طبیعی با TIM API تعامل داشته باشید.

کاربر: میزان انتشار گازهای گلخانه‌ای پرواز LX 52 از زوریخ به بوستون چقدر است؟

نماینده: میزان انتشار کربن پیش‌بینی‌شده به ازای هر مسافر برای پرواز LX 52 خطوط هوایی سوئیس اینترنشنال از زوریخ (ZRH) به بوستون (BOS) برای امروز، ۲۵ مارس ۲۰۲۶، به شرح زیر است:

• اقتصاد: ۳۵۴.۱۰ کیلوگرم CO2e
• پریمیوم اکونومی: ۵۳۱.۱۴ کیلوگرم CO2e
• کسب و کار: ۱۴۱۶.۳۸ کیلوگرم CO2e
• اول: ۱۷۷۰.۴۸ کیلوگرم CO2e

این پرواز دارای اثر ردّ دنباله‌های متوسطی است.

کاربر: میزان انتشار گازهای گلخانه‌ای از زوریخ تا بوستون معمولاً چقدر است؟

نماینده: میزان انتشار کربن معمول به ازای هر مسافر برای پرواز از زوریخ (ZRH) به بوستون (BOS) به شرح زیر است:

• اقتصاد: ۴۱۵.۴۱ کیلوگرم CO2e
• اقتصاد ممتاز: ۵۸۲.۰۰ کیلوگرم CO2e
• کسب و کار: ۱۴۷۳.۹۵ کیلوگرم CO2e
• اول: ۱۸۱۷.۳۵ کیلوگرم CO2e