MCP Reference: developerknowledge.googleapis.com

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

راه اندازی سرور

قبل از استفاده، باید سرورهای MCP را فعال کرده و احراز هویت را تنظیم کنید . برای اطلاعات بیشتر در مورد استفاده از سرورهای MCP از راه دور گوگل و گوگل کلود، به نمای کلی سرورهای MCP گوگل کلود مراجعه کنید.

نقاط پایانی سرور

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

سرور MCP مربوط به Developer Knowledge API دارای نقطه پایانی MCP سراسری زیر است:

  • https://developerknowledge.googleapis.com/mcp

ابزارهای MCP

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

ابزارها

سرور MCP مربوط به developerknowledge.googleapis.com ابزارهای زیر را دارد:

ابزارهای MCP
search_documents

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

  • ADK: adk.dev

  • اندروید: developer.android.com

  • آپیجی: docs.apigee.com

  • کروم: developer.chrome.com

  • دارت: dart.dev

  • فایربیس: firebase.google.com

  • فلاتر: docs.flutter.dev

  • فوشیا: fuchsia.dev

  • رابط خط فرمان جمینی: geminicli.com

  • برو: go.dev

  • هوش مصنوعی گوگل: ai.google.dev

  • گوگل ضد جاذبه: antigravity.google

  • گوگل کلود: cloud.google.com و docs.cloud.google.com

  • توسعه‌دهندگان گوگل، تبلیغات، جستجو، نقشه‌های گوگل، یوتیوب: developers.google.com

  • گوگل هوم: developers.home.google.com

  • پلتفرم نقشه گوگل: mapsplatform.google.com

  • تنسورفلو: www.tensorflow.org

  • وب: web.dev

این ابزار تکه‌هایی از متن، نام‌ها و URLها را برای اسناد منطبق برمی‌گرداند. اگر تکه‌های برگردانده شده به اندازه کافی دقیق نیستند تا به سوال کاربر پاسخ دهند، از get_documents به همراه parent خروجی این ابزار برای بازیابی محتوای کامل سند استفاده کنید.

answer_query

از answer_query برای دریافت پاسخی مستدل به یک پرسش در مورد محصولات توسعه‌دهندگان گوگل استفاده کنید. این ابزار سهمیه محدودی دارد. این ابزار اطلاعات را از مجموعه داده‌ها ترکیب می‌کند تا پاسخی برای پرسش ایجاد کند. answer_query پاسخ‌ها را با استفاده از همان مجموعه داده‌های search_documents زمینه‌سازی می‌کند. این ابزار answer_text تولید شده و لیستی از نام‌های سند (مرجع‌ها) مورد استفاده برای تولید پاسخ را برمی‌گرداند. در صورت نیاز، از get_documents به همراه نام‌های سند برای دریافت کل محتوای سند استفاده کنید.

اگر با خطای ۴۲۹ «خارج از سهمیه» مواجه شدید، به جای آن از search_documents استفاده کنید.

get_documents از این ابزار برای بازیابی محتوای کامل یک سند یا حداکثر ۲۰ سند در یک فراخوانی واحد استفاده کنید. نام اسناد باید از فیلد parent نتایج حاصل از فراخوانی ابزار search_documents به دست آید. پارامتر names را روی لیستی از نام اسناد تنظیم کنید.

مشخصات ابزار MCP را دریافت کنید

برای دریافت مشخصات ابزار MCP برای همه ابزارهای موجود در یک سرور MCP، از متد tools/list استفاده کنید. مثال زیر نحوه استفاده از curl برای فهرست کردن همه ابزارها و مشخصات آنها که در حال حاضر در سرور MCP موجود هستند را نشان می‌دهد.

درخواست کرل 
                      
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'