MCP Reference: developerknowledge.googleapis.com

Model Context Protocol (MCP) sunucusu, Büyük Dil Modeli'ne (LLM) veya yapay zeka uygulamasına bağlam, veri ya da özellikler sağlayan harici bir hizmet ile bu hizmeti kullanan uygulama arasında proxy görevi görür. MCP sunucuları, yapay zeka uygulamalarını veritabanları ve web hizmetleri gibi harici sistemlere bağlar ve yanıtlarını yapay zeka uygulamasının anlayabileceği bir biçime çevirir.

Sunucu Kurulumu

Kullanmadan önce MCP sunucularını etkinleştirmeniz ve kimlik doğrulamayı ayarlamanız gerekir. Google ve Google Cloud uzaktan MCP sunucularını kullanma hakkında daha fazla bilgi için Google Cloud MCP sunucularına genel bakış başlıklı makaleyi inceleyin.

Sunucu uç noktaları

MCP hizmeti uç noktası, bir yapay zeka uygulamasının (MCP istemcisinin ana makinesi) güvenli ve standartlaştırılmış bir bağlantı oluşturmak için kullandığı MCP sunucusunun ağ adresi ve iletişim arayüzüdür (genellikle bir URL). LLM'nin bağlam istemek, bir aracı çağırmak veya bir kaynağa erişmek için kullandığı iletişim noktasıdır. Google MCP uç noktaları küresel veya bölgesel olabilir.

developerknowledge.googleapis.com MCP sunucusunun aşağıdaki MCP uç noktası vardır:

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

MCP Araçları

MCP aracı, bir MCP sunucusunun gerçek dünyada işlem yapmak için bir LLM'ye veya yapay zeka uygulamasına sunduğu bir işlev ya da yürütülebilir özelliktir.

developerknowledge.googleapis.com MCP sunucusunda aşağıdaki araçlar bulunur:

MCP Araçları
search_documents

Google geliştirici ürünleriyle ilgili dokümanları bulmak için bu aracı kullanın. Belgelerde resmi API'ler, kod snippet'leri, sürüm notları, en iyi uygulamalar, kılavuzlar, hata ayıklama bilgileri ve daha fazlası yer alır. Aşağıdaki ürünler ve alanlar kapsamındadır:

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Firebase: firebase.google.com

  • Fuchsia: fuchsia.dev

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Cloud: docs.cloud.google.com

  • Google Developers, Ads, Search, Google Maps, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Bu araç, eşleşen belgeler için metin parçaları, adlar ve URL'ler döndürür. Döndürülen parçalar, kullanıcının sorusunu yanıtlamak için yeterince ayrıntılı değilse tam belge içeriğini almak üzere bu aracın çıktısındaki parent ile birlikte get_documents kullanın.
answer_query Google geliştirici ürünleriyle ilgili bir sorguya temellendirilmiş yanıt almak için answer_query'yi kullanın. Bu aracın kotası sınırlıdır. Bu araç, sorguya yanıt oluşturmak için topluluktaki bilgileri sentezler. answer_query, yanıtları search_documents ile aynı topluluğu kullanarak temellendirir. Kota dışı 429 hatası alırsanız bunun yerine search_documents'ı kullanın.
get_documents Tek bir dokümanın veya tek bir çağrıda en fazla 20 dokümanın tam içeriğini almak için bu aracı kullanın. Belge adları, search_documents aracına yapılan bir çağrının sonuçlarındaki parent alanından alınmalıdır. names parametresini bir doküman adı listesine ayarlayın.

MCP aracı özelliklerini alma

Bir MCP sunucusundaki tüm araçlar için MCP aracı özelliklerini almak üzere tools/list yöntemini kullanın. Aşağıdaki örnekte, MCP sunucusunda şu anda kullanılabilen tüm araçları ve özelliklerini listelemek için curl komutunun nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
                      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
}'