Google Drive MCP Server

Google Drive MCP サーバー

Google Drive API と連携するための Model Context Protocol（MCP）サーバーです。このサーバーは、AI システムが Google Drive 内のファイルにアクセスして操作するための標準化されたインターフェースを提供します。

機能

• ファイル操作：ファイルの一覧表示、アップロード、ダウンロード、削除
• フォルダー管理：フォルダーの作成とコンテンツの整理
• ファイル共有：特定のユーザーとのファイル共有と権限の管理
• ページネーションのサポート：大量のファイル一覧を効率的に処理
• 包括的なエラー処理：デバッグを容易にする詳細なエラー報告

前提条件

• Python 3.8+
• Drive API を有効にした Google Cloud プロジェクト
• 適切な権限を持つサービスアカウント

セットアップ

1. Google Cloud のセットアップ

1. Google Cloud Console でプロジェクトを作成します
2. Google Drive API を有効にします
3. 適切な権限を持つサービスアカウントを作成します
4. サービスアカウントの JSON キーファイルをダウンロードします

2. ローカルでのセットアップ

リポジトリをクローンし、依存関係をインストールします：

# Clone the repository
git clone <repository-url>
cd mcp-server-gdrive

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Copy example environment file and edit with your settings
cp .env.example .env

.env ファイルを編集して設定を行います：

HOST=0.0.0.0
PORT=8055
GOOGLE_SERVICE_ACCOUNT_FILE=your-service-account-file.json

3. Docker のセットアップ

または、Docker を使用できます：

# Build and run with Docker Compose
docker-compose up --build

サーバーの実行

ローカルでの実行

python main.py --transport sse

Docker での実行

docker-compose up

MCP ツール

このサーバーは、次の MCP ツールを提供します：

ファイル操作

• list_files：ページネーションをサポートして Google Drive 内のファイルを一覧表示します
• get_file_info：特定のファイルの詳細情報を取得します
• upload_file：ファイルを Google Drive にアップロードします
• download_file：ファイルを Google Drive からダウンロードします

フォルダー操作

• create_folder：Google Drive に新しいフォルダーを作成します

共有と権限

• share_file：ファイルまたはフォルダーを別のユーザーと共有します

デバッグ

• debug_api_connection：Google Drive API 接続をデバッグします

クライアントの設定

クライアントからこの MCP サーバーに接続するには：

{
  "gdrive": {
    "transport": "sse",
    "serverUrl": "http://localhost:8055/sse"
  }
}

注：SSE トランスポートを使用する場合は、URL の末尾に /sse を含めてください。

セキュリティに関する考慮事項

• サービスアカウントの JSON ファイルには機密性の高い認証情報が含まれています。バージョン管理に登録しないでください。
• すべての機密性の高い設定には環境変数を使用してください。
• 公開環境にデプロイする場合は、追加の認証の実装を検討してください。

ライセンス

MIT ライセンス

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。