MCP Reference: drivemcp.googleapis.com

デベロッパー プレビュー: Google Workspace デベロッパー プレビュー プログラムの一環として利用できます。このプログラムでは、特定の機能に早期アクセスできます。

これは、Drive API によって提供される MCP サーバーです。サーバーは、デベロッパーがドライブ上に LLM アプリケーションを構築するためのツールを提供します。

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 エンドポイントをグローバルまたはリージョンにすることができます。

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

• https://drivemcp.googleapis.com/mcp/v1

MCP ツール

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

ツール

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

MCP ツール
create_file	このツールを呼び出して、Google ドライブにファイルを作成またはアップロードします。 ファイルをアップロードする場合は、アップロードするファイルの MIME タイプに関係なく、コンテンツを content フィールドに Base64 でエンコードする必要があります。 作成が成功すると、単一の File オブジェクトを返します。 次の Google ドライブのファーストパーティ MIME タイプは、コンテンツを指定せずに作成できます。 application/vnd.google-apps.document application/vnd.google-apps.spreadsheet application/vnd.google-apps.presentation デフォルトでは、次の MIME タイプに対して次の変換が行われます。 text/plain から application/vnd.google-apps.document text/csv から application/vnd.google-apps.spreadsheet ファーストパーティの MIME タイプの変換を無効にするには、disable_conversion_to_google_type を true に設定します。 フォルダは、MIME タイプを application/vnd.google-apps.folder に設定することで作成できます。
download_file_content	このツールを呼び出して、ドライブ ファイルのコンテンツを生のバイナリデータ（バイト）としてダウンロードします。 ファイルが Google ドライブのファースト パーティの MIME タイプの場合、exportMimeType フィールドは必須であり、ダウンロードしたファイルの形式を決定します。 ファイルが見つからない場合は、search_files などの他のツールを使用して、お客様がリクエストしているファイルを探します。 ユーザーがドライブ コンテンツの自然言語表現を必要としている場合は、read_file_content ツールを使用します（read_file_content は小さく、解析しやすいものにする必要があります）。
get_file_metadata	このツールを呼び出して、ユーザーのドライブ ファイルに関する一般的なメタデータを取得します。 ファイルが見つからない場合は、search_files などの他のツールを使用して、お客様がリクエストしているファイルを探します。
get_file_permissions	このツールを呼び出して、ドライブ ファイルの権限を一覧表示します。
list_recent_files	このツールを呼び出して、並べ替え順序を指定したユーザーの最近のファイルを見つけます。デフォルトの並べ替え順は recency です。 サポートされている並べ替え順序は次のとおりです。 recency: ファイルの日付 / 時刻フィールドの最新のタイムスタンプ。 lastModified: 誰かが最後にファイルを変更した日時。 lastModifiedByMe: ユーザーが最後にファイルを変更した日時。 デフォルトのページサイズは 10 です。next_page_token を使用して結果をページ分けします。
read_file_content	このツールを呼び出して、ドライブ ファイルの自然言語表現を取得します。 ファイルが非常に大きい場合、ファイルの内容が不完全になることがあります。テキスト表現は時間の経過とともに変化するため、このツールから返されるテキストの特定の形式について想定しないでください。 サポートされている MIME タイプ: application/vnd.google-apps.document application/vnd.google-apps.presentation application/vnd.google-apps.spreadsheet application/pdf application/msword application/vnd.openxmlformats-officedocument.wordprocessingml.document application/vnd.openxmlformats-officedocument.spreadsheetml.sheet application/vnd.openxmlformats-officedocument.presentationml.presentation application/vnd.oasis.opendocument.spreadsheet application/vnd.oasis.opendocument.presentation application/x-vnd.oasis.opendocument.text image/png image/jpeg image/jpg ファイルが見つからない場合は、search_files などの他のツールを使用して、お客様がリクエストしているファイルをキーワードで検索してみてください。
search_files	このツールを呼び出して、構造化されたクエリに基づいてドライブ ファイルを検索します。 query フィールドでは、クエリ検索演算子を使用する必要があります。 クエリ文字列には、次の 3 つの部分が含まれます。query_term operator values（ここで、 query_term は、検索するクエリ語句またはフィールドです。 operator は、クエリ用語の条件を指定します。 values は、検索結果をフィルタリングするために使用する特定の値です。 クエリ語句 次の表に、有効なクエリ用語とその説明を示します。 クエリ語句 有効な演算子 用途 title contains、=、!= ファイルのタイトル。単一引用符（'）で囲みます。クエリ内の単一引用符は \' を使ってエスケープします（例: 'Valentine\'s Day'）。 fullText contains ファイルのコンテンツ内の title またはテキストが一致するかどうか。単一引用符（'）で囲みます。クエリ内の単一引用符は \' を使ってエスケープします（例: 'Valentine\'s Day'）。 mimeType contains、=、!= ファイルの MIME タイプ。単一引用符（'）で囲みます。クエリ内の単一引用符は \' を使ってエスケープします（例: 'Valentine\'s Day'）。 modifiedTime <=、<、=、!=、>、>= ファイルの最終更新日。RFC 3339 形式。デフォルトのタイムゾーンは UTC（例: 2012-06-04T12:00:00-08:00）。date 型のフィールドは比較できません。 viewedByMeTime <=、<、=、!=、>、>= ユーザーが最後にファイルを閲覧した日付。RFC 3339 形式。デフォルトのタイムゾーンは UTC（例: 2012-06-04T12:00:00-08:00）。date 型のフィールドは比較できません。 parentId =、!= 親が指定された ID と等しいかどうか。root を使用して、ユーザーのプライマリ階層として機能する [マイドライブ] を指定できます。 owner =、!= ファイルのオーナー。me を使用して、リクエストを行っているユーザーを指定できます。 sharedWithMe =、!= ユーザーの [共有アイテム] コレクションにあるファイル。すべてのファイル ユーザーがファイルのアクセス制御リスト（ACL）に含まれています。true または false のいずれかになります。 createdTime <=、<、=、!=、>、>= ファイルが作成された日付。RFC 3339 形式を使用します。デフォルトのタイムゾーンは UTC です（例: 2012-06-04T12:00:00-08:00）。 クエリ演算子 次の表に、有効なクエリ演算子を示します。 オペレーター 用途 contains 一方の文字列の内容が他方の文字列に含まれている。 = 文字列またはブール値の内容が他方と等しい。 != 文字列またはブール値のコンテンツが等しくない。 < 値が別の値より小さい。 <= ある値が別の値以下である。 > ある値が別の値より大きい。 >= 値がもう一方の値以上である。 in 要素はコレクション内に含まれます。 and 両方のクエリに一致するアイテムを返します。 or いずれかのクエリに一致するアイテムを返します。 not 検索クエリを否定します。 has コレクションにパラメータに一致する要素が含まれている。 クエリの例を次に示します。 title contains 'hello' and title contains 'goodbye' modifiedTime > '2024-01-01T00:00:00Z' and (mimeType contains 'image/' or mimeType contains 'video/') parentId = '1234567' fullText contains 'hello' owner = '[e-mail]' sharedWithMe = true owner = 'me'（ユーザーがオーナーのファイルの場合） next_page_token を使用して結果をページ分けします。空のレスポンスは、結果がないか、返される結果がないことを示します。

MCP ツールの仕様を取得する

MCP サーバー内のすべてのツールの MCP ツール仕様を取得するには、tools/list メソッドを使用します。次の例は、curl を使用して、MCP サーバー内で現在使用可能なすべてのツールとその仕様を一覧表示する方法を示しています。

Curl リクエスト
curl --location 'https://drivemcp.googleapis.com/mcp/v1' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }'