سرور 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. پس از ایجاد کلید، برای مشاهده آن روی نمایش کلید کلیک کنید و آن را برای مرحله بعدی کپی کنید.

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

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

Enter your API key: YOUR_API_KEY

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

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

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

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

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

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

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

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

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

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

مثال تأیید (خط فرمان ضد جاذبه)

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

   agy
   

   

2. ماکروی چک لیست کشف را برای بررسی سرورهای فعال MCP اجرا کنید:

   /mcp
   

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

   

4. برای مثال از گوگل هوم یک سوال بپرسید:

   How do I create an Automation using Home APIs?
   

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

   

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

   

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

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

پروتکل‌های تست مستقیم HTTP API (cURL)

برای آزمایش خط لوله در خارج از محیط بسته‌بندی کلاینت، می‌توان بارهای داده استاندارد JSON-RPC را از طریق کانال‌های curl تحویل داد.

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

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

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

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--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' \
--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?"
        }
    }
}'

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

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

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