MCP Google Workspace サーバー

AI エージェントが Google Workspace（ドライブ、ドキュメント、スプレッドシート）サービスと対話できるようにするモデル コンテキスト プロトコル（MCP）サーバー。

🌟 特徴

• Google ドライブ: ファイルの検索、フォルダの作成

• Google ドキュメント: ドキュメントの作成、閲覧、更新

• Google スプレッドシート: スプレッドシートを作成し、セルの値を読み書きする

• 複数のトランスポートモード: stdio (デフォルト)、SSE、WebSocket

• MCP対応クライアントサポート（カーソル等）

Related MCP server: MCP Google Suite

📋 インストール

uvの使用（推奨）

uvx mcp-google-suite

pipの使用

pip install mcp-google-suite

開発セットアップ

# Clone and install
git clone git@github.com:adexltd/mcp-google-suite.git && cd mcp-google-suite
uv venv && source .venv/bin/activate  # or .venv\Scripts\activate on Windows
uv pip install -e .

🔧 構成

MCPクライアント用の構成

クライアント設定に追加します (例: Cursor、Claude):

uvx の使用 (推奨):

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "uvx",
      "args": ["mcp-google-suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

pip インストールを使用する:

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "python",
      "args": ["-m", "mcp_google_suite"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

Google OAuth 設定

1. Google Cloud Consoleにアクセス

2. ドライブ、ドキュメント、スプレッドシートの API を有効にする

3. OAuth 2.0認証情報を作成する

4. ~/.google/oauth.keys.jsonとして保存します。

5. 認証するにはmcp-google authを実行します

利用可能なツール

ドライブ操作

• drive_search_files : Google ドライブ内のファイルを検索する

  • query (文字列、必須): 検索クエリ

  • page_size (整数、オプション): 返される結果の数

• drive_create_folder : 新しいフォルダを作成する

  • name (文字列、必須): フォルダ名

  • parent_id (文字列、オプション): 親フォルダID

ドキュメント操作

• docs_create : 新しいドキュメントを作成する

  • title (文字列、必須): ドキュメントのタイトル

  • content （文字列、オプション）: 初期コンテンツ

• docs_get_content : ドキュメントの内容を取得する

  • document_id (文字列、必須): ドキュメントID

• docs_update_content : ドキュメントコンテンツを更新する

  • document_id (文字列、必須): ドキュメントID

  • content （文字列、必須）: 新しいコンテンツ

シート操作

• sheets_create : 新しいスプレッドシートを作成する

  • title (文字列、必須): スプレッドシートのタイトル

  • sheets （配列、オプション）: シート名

• sheets_get_values : セルの値を取得する

  • spreadsheet_id (文字列、必須): スプレッドシートID

  • range （文字列、必須）: A1表記の範囲

• sheets_update_values : セルの値を更新する

  • spreadsheet_id (文字列、必須): スプレッドシートID

  • range （文字列、必須）: A1表記の範囲

  • values （配列、必須）: 値の2次元配列

🛠️ 開発

# Install dev dependencies
uv pip install -e ".[dev]"

# Setup pre-commit hooks
pre-commit install

# Run tests
pytest

# Format code
black . && ruff check --fix .

🔍 デバッグ

対話型テストには MCP Inspector を使用します。

# Using uvx
npx @modelcontextprotocol/inspector uvx mcp-google

# For development
cd path/to/mcp-google-suite
npx @modelcontextprotocol/inspector uv run mcp-google

📚 リソース

• ドキュメント

• MCP検査官

• コミット前フック

• Google Cloud コンソール

🤝 貢献する

行動規範とプル リクエストの送信プロセスの詳細については、 CONTRIBUTING.md をお読みください。

🔒 セキュリティ

脆弱性の報告とベストプラクティスについては、 SECURITY.md を参照してください。

📄 ライセンス

MIT ライセンス - 詳細についてはLICENSEファイルを参照してください。