Google Drive & Sheets MCP Server

Google Drive & Sheets MCP サーバー

Google Drive および Google Sheets と連携するために Rust で構築された Model Context Protocol（MCP）サーバーです。このツールは Google Workspace サービス向けの MCP 互換インターフェースを提供し、より大規模なエージェントのワークフローや構成の一部として利用できます。

機能

Google Drive の操作

• Google Drive 内のファイルを、次のオプションでフィルタリングして一覧表示します：
  • MIME タイプによるフィルタリング
  • カスタム検索クエリ
  • 設定可能なページサイズ
  • カスタム並べ替え

Google Sheets の操作

• 次のオプションで Google Sheets のデータを読み取ります：
  • 範囲の指定
  • 主要な次元の選択（ROWS または COLUMNS）
• Google Sheets にデータを書き込みます
• 次の内容を指定して新しいスプレッドシートを作成します：
  • カスタムタイトル
  • 複数のシート
• スプレッドシートの範囲から値を消去します

MCP 連携

このサーバーは Model Context Protocol（MCP）を実装しているため、Distri などのエージェントフレームワークと互換性があります。各サービスは、機能を MCP ツールとして公開します：

Drive ツール

• list_files：カスタマイズ可能なパラメーターで Drive のファイルを一覧表示し、フィルタリングします
• 利用可能な機能は resources/list エンドポイントで公開されます

Sheets ツール

• read_values：次元を指定してスプレッドシートのデータを読み取ります
• write_values：スプレッドシートにデータを書き込みます
• create_spreadsheet：新しいスプレッドシートを作成します
• clear_values：スプレッドシートの範囲を消去します
• 利用可能な機能は resources/list エンドポイントで公開されます

前提条件

• Rust（最新の安定版）
• Drive API と Sheets API を有効にした Google Cloud プロジェクト
• Google Cloud プロジェクト用に設定された OAuth 2.0 認証情報

インストール

Cargo を使って、GitHub から mcp-google バイナリを直接インストールします：

cargo install --git https://github.com/distrihub/mcp-google-workspace.git

これにより、mcp-google コマンドがシステムにインストールされます。

設定

サーバーを使用する前に、次の設定が必要です：

1. Google Cloud プロジェクトをセットアップします
2. Google Drive API と Google Sheets APIss を有効にします
3. OAuth 2.0 認証情報を作成します
4. 環境変数を設定します：
   • ACCESS_TOKEN：Google OAuth アクセストークン
   • GOOGLE_CLIENT_ID：OAuth クライアント ID
   • GOOGLE_CLIENT_SECRET：OAuth クライアントシークレット
   • GOOGLE_REFRESH_TOKEN：OAuth リフレッシュトークン

使用方法

MCP サーバーとして

サーバーは個別に起動でき、stdio 経由で MCP プロトコルを使用して通信します：

Drive MCP サーバーを起動します：

mcp-google drive --access-token <your-access-token>

Sheets MCP サーバーを起動します：

mcp-google sheets --access-token <your-access-token>

Distri での使用

このサーバーは Distri エージェントの設定の一部として使用できます：

agents:
  google_workspace:
    drive:
      type: mcp
      command: ["mcp-google", "drive", "--access-token", "${ACCESS_TOKEN}"]
    sheets:
      type: mcp
      command: ["mcp-google", "sheets", "--access-token", "${ACCESS_TOKEN}"]

トークン管理

OAuth トークンを更新します：

mcp-google refresh \
  --client-id <your-client-id> \
  --client-secret <your-client-secret> \
  --refresh-token <your-refresh-token>

ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。詳細は LICENSE ファイルをご覧ください。

コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を送信してください。

注意

これは Google サービスと連携する MCP 互換サーバーです。このツールを使用する前に、適切な権限と認証情報があることを確認してください。