سرور MCP توسعه‌دهنده گوگل هوم

سرور پروتکل زمینه مدل توسعه‌دهنده گوگل هوم (MCP) به ابزارهای توسعه مبتنی بر هوش مصنوعی این امکان را می‌دهد که موارد زیر را جستجو کرده و اطلاعات خاص دامنه را به صورت بلادرنگ بازیابی کنند:

• مستندات عمومی مرکز توسعه‌دهندگان گوگل هوم
• باز کردن
• مشخصات Matter : برای نسخه ۱.۵.۱ موجود است
• مشخصات رزوه : موجود برای نسخه ۱.۴.۱

این امر تضمین می‌کند که عوامل و ابزارهای هوش مصنوعی می‌توانند پاسخ‌های فنی دقیقی مربوط به برنامه‌ها و فناوری توسعه‌دهندگان Google Home ارائه دهند.

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

پیش‌نیازها

برای استفاده از سرور MCP توسعه‌دهنده خانگی، باید یک کلاینت یا ویرایشگر هوش مصنوعی سازگار با MCP نصب کرده باشید.

گوگل ضد جاذبه

اگر از محیط توسعه هوش مصنوعی گوگل استفاده می‌کنید، یکی از موارد زیر را نصب کنید:

• رابط خط فرمان آنتی‌گراویتی، طبق راهنمای شروع به کار با رابط خط فرمان آنتی‌گراویتی
• ضد جاذبه ۲.۰، مطابق با مستندات ضد جاذبه گوگل
• Antigravity IDE، طبق راهنمای شروع به کار با Antigravity IDE

دستیاران هوش مصنوعی شخص ثالث

همچنین می‌توانید MCP را با سایر برنامه‌های هوش مصنوعی، ابزارهای خط فرمان و ویرایشگرهای کد، مانند موارد زیر، ادغام کنید:

• کلود کد
• مکان نما
• گیت‌هاب کوپایلوت در VS Code

انتخاب مسیر احراز هویت

بسته به نیازهای یکپارچه‌سازی خود، می‌توانید با استفاده از یک مسیر آزمایشی احراز هویت نشده یا یک کلید API احراز هویت شده به سرور Home Developer MCP متصل شوید.

آزمایش اتصال احراز هویت نشده

این روش نیازی به کلید API یا پیکربندی Google Cloud ندارد. از سهمیه عمومی مشترک استفاده می‌کند و آن را به ساده‌ترین راه برای آزمایش فوری سرور و بررسی مکانیک‌های اصلی تبدیل می‌کند.

اتصال احراز هویت شده برای تولید

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

این مسیر مستلزم آن است که شما یک پروژه فعال Google Cloud داشته باشید.

1. در کنسول Google Cloud، API را در پروژه خود فعال کنید:
   1. صفحه API توسعه‌دهندگان خانگی را در کتابخانه APIهای گوگل باز کنید.
   2. بررسی کنید که پروژه‌ی درستی را که قصد دارید در آن از API استفاده کنید، انتخاب کرده‌اید.
   3. روی فعال کردن کلیک کنید.

2. ایجاد کلید API:

   1. به صفحه اعتبارنامه‌ها بروید.
   2. روی ایجاد اعتبارنامه کلیک کنید و سپس کلید API را از منو انتخاب کنید.
   3. در قسمت نام ، یک نام برای کلید وارد کنید.

   4. روی منوی کشویی «انتخاب محدودیت‌های API» کلیک کنید و سپس عبارت «Home Developers API» را تایپ کنید. روی نتیجه کلیک کنید و سپس روی «تأیید» کلیک کنید.

   5. روی ایجاد کلیک کنید.

   6. پس از ایجاد کلید، برای مشاهده آن روی نمایش کلید کلیک کنید و آن را برای مرحله بعدی کپی کنید.

کلاینت خود را پیکربندی کنید

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

Enter your API key: YOUR_API_KEY

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

{
  "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

claude mcp add HomeDevelopers \
  --transport http https://homedevelopers.googleapis.com/mcp \
  --header "X-Goog-Api-Key: YOUR_API_KEY"

claude mcp add HomeDevelopers \
  --transport http https://homedevelopers.googleapis.com/mcp

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

تأیید نصب و اجرا

پس از به‌روزرسانی پیکربندی ابزار، با فراخوانی فضای کاری عامل، اتصال را تأیید کنید.

مثال تأیید در Antigravity CLI

1. جلسه فضای کاری تعاملی خود را راه‌اندازی کنید:

   agy
   

   

2. دستور discovery checklist را برای بررسی سرورهای فعال MCP اجرا کنید:

   /mcp
   

3. تأیید کنید که HomeDevelopers (یا کلید نام سرور انتخابی شما) در لیست اتصالات فعال ظاهر می‌شود.

   

4. برای مثال، یک سوال در مورد توسعه Google Home بپرسید:

   How do I create an Automation using Home APIs?
   

5. وقتی Antigravity درخواست اجازه برای فراخوانی ابزار search_documents سرور Home Developer MCP را دارد، برای ادامه هر یک از گزینه‌های Allow را انتخاب کنید.

   

6. پس از فراخوانی ابزار، Antigravity با پاسخی مستدل از مستندات به درخواست شما پاسخ می‌دهد.

   

آموزش ویدیویی

برای راهنمای گام به گام نصب MCP توسعه دهنده خانگی، این ویدیو را تماشا کنید.

با درخواست‌های مستقیم HTTP curl تست کنید

برای آزمایش خط لوله خارج از محیط کلاینت هوش مصنوعی، می‌توانید با استفاده از curl ، بارهای داده استاندارد JSON-RPC 2.0 را مستقیماً به https://homedevelopers.googleapis.com/mcp ارسال کنید.

ابزارهای فعال سیستم را کشف کنید

از متد tools/list برای بررسی ابزارهای نمایش داده شده توسط سرور استفاده کنید:

curl --location "https://homedevelopers.googleapis.com/mcp" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --data '{
      "jsonrpc": "2.0",
      "method": "tools/list",
      "id": 1
  }'

اجرای یک کوئری جستجوی کاربردی

یک برگه را برای آزمایش search_documents با استفاده از یک کلید API یا یک درخواست احراز هویت نشده انتخاب کنید:

curl --location "https://homedevelopers.googleapis.com/mcp" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --header "X-Goog-Api-Key: YOUR_API_KEY" \
  --data '{
      "jsonrpc": "2.0",
      "method": "tools/call",
      "id": 2,
      "params": {
          "name": "search_documents",
          "arguments": {
              "query": "How to create an automation?"
          }
      }
  }'

curl --location "https://homedevelopers.googleapis.com/mcp" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --data '{
      "jsonrpc": "2.0",
      "method": "tools/call",
      "id": 2,
      "params": {
          "name": "search_documents",
          "arguments": {
              "query": "How to create an automation?"
          }
      }
  }'

ارسال بازخورد

از فرم بازخورد ما برای ارسال نظرات و پیشنهادات خود در مورد Home Developer MCP یا اینکه چگونه می‌توانیم تجربه شما را با این ابزار بهبود بخشیم، استفاده کنید.

نظرات خود را برای ما ارسال کنید