MCP Reference: developerknowledge.googleapis.com

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

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

قبل‌از استفاده باید سرورهای MCP را فعال کنید و اصالت‌سنجی را راه‌اندازی کنید. برای اطلاعات بیشتر درباره استفاده از سرورهای MCP ازراه‌دور Google و Google Cloud، به نمای کلی سرورهای Google Cloud MCP مراجعه کنید.

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

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

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

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

ابزارهای «پروتکل زمینه‌ای مدل» (MCP)

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

ابزارها

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

ابزارهای «پروتکل زمینه‌ای مدل» (MCP)
search_documents

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

  • ADK: adk.dev

  • ‫Android: developer.android.com

  • Apigee: docs.apigee.com

  • ‫Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • ‫Flutter: ‏ docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • ‫Gemini CLI: geminicli.com

  • Genkit: genkit.dev

  • Go: go.dev

  • Google AI: ai.google.dev

  • ‫Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com & docs.cloud.google.com

  • Google Developers،‏ Ads، «جستجو»، Google Maps،‏ Youtube: developers.google.com

  • Google Home: developers.home.google.com

  • پلاتفرم Google Maps: mapsplatform.google.com

  • ‫Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • وب: web.dev

این ابزار بخش‌هایی از نوشتار، نام‌ها، و شناسه منبع یکسان را برای اسناد منطبق برمی‌گرداند. وقتی به نمونه‌های کد دقیق، پرچم‌های CLI، پیام‌های خطای خاص، راهنماهای آموزشی کامل، یا جستجوی کلیدواژه قطعی نیاز دارید، search_documents و سپس get_documents را ترجیح دهید. اگر بخش‌های برگردانده‌شده به‌اندازه کافی جزئیات ندارند تا به سؤال کاربر پاسخ دهند، از get_documents با parent از خروجی این ابزار استفاده کنید تا محتوای کامل سند را بازیابی کنید. When answering the user, always cite the authoritative source document resource names (documents/...) or URIs.
answer_query

از answer_query برای دریافت پاسخ مفهومی ترکیبی و مستدل به پرسش‌های سطح بالا درباره محصولات توسعه‌دهنده Google استفاده کنید. برای نمونه‌های دقیق کد، پرچم‌های CLI، پیام‌های خطای خاص، یا راهنماهای کامل سند، بهتر است به‌جای آن از search_documents و سپس get_documents استفاده کنید. این ابزار سهمیه محدودی دارد. این ابزار اطلاعات را از مجموعه نوشتار ترکیب می‌کند تا پاسخی برای پُرسمان تولید کند. answer_query پاسخ‌ها را بااستفاده از همان مجموعه نوشتار search_documents زمینه‌سازی می‌کند. این ابزار answer_text تولیدشده و فهرستی از نام‌های سند (مرجع) را که برای تولید پاسخ استفاده شده است برمی‌گرداند. همیشه نام اسناد منبع معتبر را از references (documents/...) در پاسخ نهایی خود به کاربر ذکر کنید. درصورت نیاز، از get_documents با نام‌های سند از references برای واکشی کل محتوای سند استفاده کنید.

اگر خطای ۴۲۹ «خارج از سهمیه» دریافت کردید، به‌جای آن از search_documents استفاده کنید.
get_documents از این ابزار برای بازیابی محتوای کامل یک سند یا حداکثر ۲۰ سند در یک فراخوانی استفاده کنید. نام اسناد باید از فیلد parent نتایج حاصل از فراخوانی ابزار search_documents یا فیلد references برگردانده‌شده توسط ابزار answer_query به‌دست آید. پارامتر names را روی فهرستی از نام‌های سند (documents/...) تنظیم کن و اسناد منبع معتبر استفاده‌شده در پاسخ نهایی‌ات را ذکر کن.

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

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

درخواست Curl 
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
}'