دانش توسعه‌دهندگان گوگل: سرور MCP در Google Antigravity 2.0، IDE و/یا CLI

۱. مقدمه

دانش توسعه‌دهندگان گوگل (Google Developer Knowledge ) منبع استاندارد و قابل خواندن توسط ماشین از اسناد عمومی توسعه‌دهندگان گوگل است. این منبع از طریق رابط برنامه‌نویسی کاربردی (API) و پروتکل زمینه مدل (MCP) قابل دسترسی است تا توسعه‌دهندگان بتوانند آن را در برنامه‌ها و گردش‌های کاری خود ادغام کنند.

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

در این آزمایشگاه کد، نحوه نصب و استفاده از Developer Knowledge MCP از Antigravity 2.0، IDE و/یا CLI را خواهید آموخت. MCP یک استاندارد باز است که به مدل‌های هوش مصنوعی امکان می‌دهد تا به طور ایمن از ابزارهای ارائه شده توسط سرورهای راه دور استفاده کنند. شما Antigravity را طوری تنظیم خواهید کرد که بدون نوشتن هیچ کدی با پایگاه دانش تعامل داشته باشد!

dk_mcp_antigravity.png

کاری که انجام خواهید داد

  • API دانش توسعه‌دهندگان را در پروژه Google Cloud خود فعال کنید.
  • Antigravity را برای دسترسی به Developer Knowledge MCP پیکربندی کنید.
  • ادغام را با چند دستور امتحان کنید.

آنچه نیاز دارید

  • یک مرورگر وب مانند کروم
  • یک پروژه Google Cloud (پرداخت صورتحساب لازم نیست ).
  • Antigravity 2.0، IDE و/یا CLI روی دستگاه محلی شما نصب شده باشد. می‌توانید جزئیات بیشتر و راهنمای نصب را از وب‌سایت رسمی آن پیدا کنید.

MCPها و ابزارهای بیشتری را بررسی کنید

در این آزمایشگاه کد، ما فقط چند مثال اساسی از کارهایی که می‌توان با استفاده از سرور MCP دانش توسعه‌دهندگان گوگل انجام داد را پوشش می‌دهیم. برای مشاهده لیست کامل سرورها و ابزارهای موجود در Google MCP، به محصولات پشتیبانی شده مراجعه کنید.

دسترسی آسان به این آزمایشگاه کد

کد QR.png

۲. پیکربندی پروژه ابری

یک پروژه Google Cloud ایجاد یا انتخاب کنید

در کنسول گوگل کلود ، یک پروژه گوگل کلود انتخاب یا ایجاد کنید .

فعال کردن API

برای استفاده از سرور Developer Knowledge MCP، باید API استاندارد Developer Knowledge را فعال کنید.

کلید API را ایجاد کنید

برای استفاده از سرور Developer Knowledge MCP، باید از یک کلید API استفاده کنید. در کنسول Google Cloud ، موارد زیر را انجام دهید:

  1. به APIها و خدمات > اعتبارنامه‌ها بروید.

  1. روی + ایجاد اعتبارنامه کلیک کنید، سپس کلید API را از منو انتخاب کنید.
  2. نام را با یک نام دلخواه مانند Antigravity تنظیم کنید.
  3. روی منوی کشویی «انتخاب محدودیت‌های API» کلیک کنید، عبارت Developer Knowledge API را تایپ کنید، نتیجه را بررسی کنید و سپس روی «تأیید» کلیک کنید.

ایجاد_کلید_api.png

  1. روی ایجاد کلیک کنید.
  2. کلید API شما اکنون در صفحه تأیید نمایش داده می‌شود. آن را در کلیپ‌بورد خود کپی کنید، برای پیکربندی Antigravity در مراحل بعدی به آن نیاز خواهید داشت.

copy_api_key.png

۳. پیکربندی ضد جاذبه

حالا بیایید Antigravity را برای استفاده از نقطه پایانی MCP پیکربندی کنیم. اگر Antigravity 2.0، IDE و/یا CLI را نصب ندارید، دستورالعمل‌های موجود در وب‌سایت Antigravity را دنبال کنید.

سرورهای MCP سفارشی اضافه کنید

Antigravity 2.0، IDE و CLI یک پیکربندی مرکزی MCP را در فایل ~/.gemini/config/mcp_config.json به اشتراک می‌گذارند.

  1. آن را در ویرایشگر متن دلخواه خود باز کنید.
  2. آن را با پیکربندی سفارشی سرور MCP زیر تغییر دهید. قبل از انجام این کار، جای خالی <YOUR_API_KEY> را با کلید API که در مراحل قبلی ایجاد کرده‌اید، جایگزین کنید: 
{
  "mcpServers": {
    "google-developer-knowledge": {
      "headers": {
        "X-Goog-Api-Key": "<YOUR_API_KEY>"
      },
      "serverUrl": "https://developerknowledge.googleapis.com/mcp"
    }
    ...
  }
  ...
}
  1. آن را ذخیره کنید.

mcp_config.png

اعتبارسنجی

شما باید سرور MCP که پیکربندی کرده‌اید را به عنوان نصب شده در Antigravity ببینید: google-developer-knowledge .

ضد جاذبه ۲.۰

  1. روی تنظیمات در پایین سمت چپ کلیک کنید.
  2. به بخش سفارشی‌سازی‌ها بروید.
  3. در زیر سرورهای MCP نصب‌شده ، روی «به‌روزرسانی» کلیک کنید.

configuration_mcp_server_20.png

محیط برنامه‌نویسی ضد جاذبه

  1. تنظیمات کاربری Antigravity را از طریق منوی کشویی تنظیمات ویژه ویرایشگر در بالای پنجره باز کنید.

باز کردن_ایده_تنظیمات_کاربر.png

  1. به بخش سفارشی‌سازی‌ها بروید.
  2. در زیر سرورهای MCP نصب‌شده ، روی «به‌روزرسانی» کلیک کنید.

فایل_configured_mcp_server_ide.png

رابط خط فرمان ضد جاذبه

  1. رابط خط فرمان (CLI) را با اجرای دستور agy از یک ترمینال آغاز کنید.
  2. عبارت /mcp را تایپ کرده و اینتر را بزنید.

configuration_mcp_server_cli.png

۴. به دانش توسعه‌دهندگان دسترسی پیدا کنید

اکنون می‌توانید با استفاده از زبان طبیعی با Google Developer Knowledge تعامل داشته باشید. در اینجا چند نمونه از این دستورالعمل‌ها آورده شده است:

  • Based on the Google Developer Knowledge, does Google Workspace support MCP servers?
  • Give me a list of the Google Workspace and Cloud Run API names. Make it super short.
  • Based on the Google Developer Knowledge, create a new Python script to upload a file to Google Drive

ضد جاذبه ۲.۰

20_test.png

محیط برنامه‌نویسی ضد جاذبه

ide_test.png

رابط خط فرمان ضد جاذبه

cli_test.png

۵. تمیز کردن

برای پاکسازی پروژه گوگل کلود خود بدون حذف آن، می‌توانید رابط برنامه‌نویسی کاربردی دانش توسعه‌دهندگان (Developer Knowledge API) را که فعال کرده‌اید غیرفعال کرده و کلید API ایجاد شده را حذف کنید:

  1. در کنسول گوگل کلود، به داشبورد API & Services بروید.
  2. روی Developer Knowledge API و سپس Disable API کلیک کنید.
  3. در کنسول گوگل کلود، به API & Services > Credentials بروید.
  4. کلید API را انتخاب کنید، برای تأیید روی حذف و سپس حذف کلیک کنید.

۶. تبریک

تبریک! شما با موفقیت سرور Google Developer Knowledge MCP را با استفاده از Antigravity پیکربندی و آزمایش کردید.

اسناد مرجع