MCP Reference: developerknowledge.googleapis.com

Model Context Protocol（MCP）サーバーは、大規模言語モデル（LLM）または AI アプリケーションにコンテキスト、データ、機能を提供する外部サービスとの間のプロキシとして機能します。MCP サーバーは、AI アプリケーションをデータベースやウェブサービスなどの外部システムに接続し、そのレスポンスを AI アプリケーションが理解できる形式に変換します。

サーバーの設定

使用する前に、MCP サーバーを有効にして認証を設定する必要があります。Google と Google Cloud のリモート MCP サーバーの使用方法については、Google Cloud MCP サーバーの概要をご覧ください。

サーバー エンドポイント

MCP サービス エンドポイントは、安全で標準化された接続を確立するために AI アプリケーション（MCP クライアントのホスト）が使用する MCP サーバーのネットワーク アドレスと通信インターフェース（通常は URL）です。これは、LLM がコンテキストをリクエストしたり、ツールを呼び出したり、リソースにアクセスしたりするための接続ポイントとなります。Google MCP エンドポイントをグローバルまたはリージョンにすることができます。

Developer Knowledge API MCP サーバーには、次のグローバル MCP エンドポイントがあります。

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

MCP ツール

MCP ツールは、現実世界でアクションを実行する目的で MCP サーバーが LLM または AI アプリケーションに対して公開する関数または実行可能な機能です。

ツール

developerknowledge.googleapis.com MCP サーバーには、次のツールがあります。

MCP ツール
search_documents

このツールを使用して、Google Developers プロダクトに関するドキュメントを検索します。ドキュメントには、公式 API、コード スニペット、リリースノート、ベスト プラクティス、ガイド、デバッグ情報などが含まれています。対象となるプロダクトとドメインは次のとおりです。

  • 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、広告、検索、Google マップ、YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • ウェブ: web.dev

このツールは、一致するドキュメントのテキスト、名前、URI のチャンクを返します。正確なコードサンプル、CLI フラグ、特定のエラー メッセージ、チュートリアルの完全な手順、決定論的なキーワード検索が必要な場合は、search_documents の後に get_documents を使用することをおすすめします。返されたチャンクがユーザーの質問に回答するのに十分な詳細さでない場合は、このツールの出力の parent を指定して get_documents を使用し、ドキュメントのコンテンツ全体を取得します。ユーザーに回答する際は、信頼できるソース ドキュメントのリソース名（documents/...）または URI を必ず引用してください。
answer_query

answer_query を使用すると、Google Developers プロダクトに関する高レベルの質問に対して、グラウンディングされた、統合されたコンセプトの回答を取得できます。正確なコードサンプル、CLI フラグ、特定のエラー メッセージ、ドキュメント全体のチュートリアルについては、search_documents の後に get_documents を使用することをおすすめします。このツールの割り当てには制限があります。このツールは、コーパスの情報を合成してクエリに対する回答を生成します。answer_query は、search_documents と同じコーパスを使用して回答をグラウンディングします。このツールは、生成された answer_text と、回答の生成に使用されたドキュメント名のリスト（参照）を返します。ユーザーへの最終回答では、必ず references（documents/...）の信頼できるソース ドキュメント名を引用してください。必要に応じて、get_documents と references のドキュメント名を使用して、ドキュメントのコンテンツ全体を取得します。

429 割り当て超過エラーが発生した場合は、代わりに search_documents を使用してください。
get_documents このツールを使用すると、1 回の呼び出しで 1 つのドキュメントのコンテンツ全体、または最大 20 個のドキュメントのコンテンツ全体を取得できます。ドキュメント名は、search_documents ツールの呼び出し結果の parent フィールド、または answer_query ツールから返された references フィールドから取得する必要があります。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
}'