MCP Reference: developerknowledge.googleapis.com

Model Context Protocol (MCP) sunucusu, büyük dil modeline (LLM) veya yapay zeka uygulamasına bağlam, veri ya da özellikler sağlayan harici bir hizmet arasında proxy görevi görür. MCP sunucuları, yapay zeka uygulamalarını veritabanları ve web hizmetleri gibi harici sistemlere bağlayarak yanıtlarını yapay zeka uygulamasının anlayabileceği bir biçime dönüştürür.

Sunucu Kurulumu

Kullanmadan önce MCP sunucularını etkinleştirmeniz ve kimlik doğrulamayı ayarlamanız gerekir. Google ve Google Cloud uzak 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 hizmet uç noktası, bir yapay zeka uygulamasının (MCP istemcisinin ana makinesi) güvenli ve standart bir bağlantı kurmak 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ı global veya bölgesel olabilir.

Developer Knowledge API MCP sunucusunda aşağıdaki global MCP uç noktası bulunur:

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

MCP Araçları

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

Araçlar

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

MCP Araçları
search_documents

Google Developers ürünleriyle ilgili belgeleri 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ünleri ve alanları kapsar:

  • 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 ve docs.cloud.google.com

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

  • Google Home: developers.home.google.com

  • Google Haritalar Platformu: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Bu araç, eşleşen dokümanlar için metin parçaları, adlar ve URI'ler döndürür. Tam kod örnekleri, CLI işaretleri, belirli hata mesajları, tam eğitim adımları veya kesin anahtar kelime araması gerektiğinde search_documents ve ardından get_documents kullanın. Döndürülen parçalar kullanıcının sorusunu yanıtlayacak kadar ayrıntılı değilse bu aracın çıkışındaki parent ile get_documents aracını kullanarak belgenin tüm içeriğini alın. Kullanıcıya yanıt verirken her zaman yetkili kaynak doküman kaynak adlarını (documents/...) veya URI'larını belirtin.
answer_query

Google Developers geliştirici ürünleriyle ilgili üst düzey bir soruya kaynağa dayalı, sentezlenmiş kavramsal bir yanıt almak için answer_query aracını kullanın. Tam kod örnekleri, CLI işaretleri, belirli hata mesajları veya tam doküman açıklamaları için search_documents ve ardından get_documents kullanmayı tercih edin. Bu aracın kotası sınırlıdır. Bu araç, sorguya yanıt oluşturmak için derlemdeki bilgileri sentezler. answer_query, yanıtları search_documents ile aynı derlemi kullanarak temellendirir. Bu araç, oluşturulan answer_text değerini ve yanıtı oluşturmak için kullanılan doküman adlarının (referanslar) listesini döndürür. Kullanıcıya vereceğiniz nihai yanıtta her zaman references (documents/...) içindeki yetkili kaynak doküman adlarından alıntı yapın. Gerekirse tüm doküman içeriğini almak için references adresindeki doküman adlarıyla get_documents kullanın.

Kota aşımı nedeniyle 429 hatası alırsanız bunun yerine search_documents'ı kullanın.
get_documents Tek bir belgenin veya tek bir çağrıda en fazla 20 belgenin tam içeriğini almak için bu aracı kullanın. Doküman adları, search_documents aracına yapılan bir çağrıdan elde edilen sonuçların parent alanından veya answer_query aracının döndürdüğü references alanından alınmalıdır. names parametresini bir belge adı listesi (documents/...) olarak ayarlayın ve nihai yanıtınızda kullanılan yetkili kaynak belgelere atıfta bulunun.

MCP aracı özelliklerini alma

Bir MCP sunucusundaki tüm araçların MCP aracı spesifikasyonlarını almak için tools/list yöntemini kullanın. Aşağıdaki örnekte, MCP sunucusunda mevcut olan tüm araçları ve özelliklerini listelemek için curl aracının 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
}'