Google MCP Remote

Google MCP Remote

Cloudflare Workers ベースの MCP サーバーの実装です。Model Context Protocol向けに、Google API のツール（Gmail、Calendar、Drive など）を提供し、Claude や Cursor などの AI クライアントとシームレスに連携できるよう設計されています。

⚠️ セキュリティ警告：他の人がデプロイしたこのサーバーのインスタンスは使用しないでください。Google アカウントと個人データへのアクセスが必要です。データと API アクセスを常に自分で管理できるよう、必ず自分専用のインスタンスをデプロイしてください。

機能

• Gmail：
  • 複数の宛先（to、cc、bcc）と HTML コンテンツを含むメールを送信
  • カスタムクエリ、ラベル、結果数の上限を指定してメールを一覧表示
  • ID を指定して特定のメールを読み取り
  • ラベルを管理（追加、削除、一覧表示）
  • メールの下書きを作成・削除
• Calendar：
  • カレンダーを一覧表示し、デフォルトのカレンダーを設定
  • 詳細情報（概要、開始／終了時刻、参加者など）を指定して予定を作成
  • カスタマイズ可能なフィルターで今後の予定を一覧表示
  • 既存の予定を更新・削除
  • スケジュール調整用の空き時間帯を検索
• Drive：
  • 検索クエリでファイルを絞り込み
  • 更新日やその他の条件で並べ替え
  • ファイルの詳細なメタデータを表示
  • ファイルの内容を読み取り（テキスト、ドキュメント、スプレッドシート）
  • 指定した内容で新しいファイルを作成
  • 既存のファイルを更新
  • ファイルを削除（ゴミ箱に移動、または完全に削除）
  • 特定の権限でファイルを共有
• Tasks：
  • すべてのタスクリストを表示
  • 新しいタスクリストを作成
  • 既存のタスクリストを削除
  • フィルターを指定してタスクを一覧表示
  • タスクの詳細を表示
  • タイトル、メモ、期限を指定してタスクを作成
  • タスクのプロパティを更新
  • タスクを完了としてマーク
  • タスクを削除
• YouTube：
  • カスタマイズ可能なパラメーターで動画を検索
  • 特定の動画の詳細情報を取得
• Contacts：
  • Google Contacts の連絡先を一覧表示・検索
  • 特定の連絡先の詳細情報を取得

デプロイ手順

前提条件

1. Google Cloud プロジェクト：

   • Google Cloud Consoleでプロジェクトを作成

   • OAuth 2.0 認証情報（Client ID と Client Secret）を設定

   • 必要な API（Gmail、Calendar、Drive、Tasks、YouTube、People/Contacts）を有効化

   • Cloudflare Worker 用の承認済み JavaScript オリジンとリダイレクト URI を追加

   • リダイレクト URI は次の形式にします：

     デプロイ済み URL + /callback
      https://your-project.your-username.workers.dev/callback
     
     ローカルテストの場合：
      http://localhost:8788/callback
     

2. Cloudflare アカウント：

   • Cloudflare アカウントを持っていない場合は登録
   • Wrangler CLI をインストール：bun install -g wrangler
   • Cloudflare で認証：wrangler login

デプロイ手順

1. リポジトリをクローン：

   git clone https://github.com/vakharwalad23/google-mcp-remote.git
   cd google-mcp-remote
   

2. 依存関係をインストール：

   bun install
   

3. シークレットを設定： Google OAuth の認証情報を Cloudflare のシークレットとして設定します：

   wrangler secret put GOOGLE_OAUTH_CLIENT_ID
   wrangler secret put GOOGLE_OAUTH_CLIENT_SECRET
   wrangler secret put COOKIE_ENCRYPTION_KEY
   

   （COOKIE_ENCRYPTION_KEY には、Cookie を保護するためのランダムな文字列を生成してください）

4. KV ネームスペースを作成：

   wrangler kv:namespace create OAUTH_KV
   

   次に、出力された ID を使って wrangler.jsonc を更新します

5. Cloudflare Workers にデプロイ：

   bun run deploy
   

6. デプロイ URL を確認： デプロイ後、Wrangler から https://your-project.your-username.workers.dev のような URL が表示されます

AI クライアントでの使用方法

デプロイ後、MCP サーバーを使用するように AI クライアント（Claude、Cursor など）を設定します。

Claude の設定

claude_desktop_config.json、または Cursor の場合は mcp.json を編集します：

{
  "mcpServers": {
    "google-mcp-remote": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-project.your-username.workers.dev/sse"
      ]
    }
  }
}

コマンド例

Google アカウントを使ってタスクを実行するよう、Claude に依頼できるようになります：

Send an email to [email protected] with the subject "Meeting Notes" and body "Here are the notes from today."

List my upcoming calendar events for the next 3 days.

Create a calendar event titled "Team Sync" tomorrow at 10 AM for 1 hour.

Search YouTube for recent videos about machine learning.

代替の使用方法

Cloudflare AI Playground での使用

Cloudflare AI Playground を使って、MCP サーバーをオンラインでテストできます。

1. Cloudflare AI Playground を開きます
2. /sse パスを付けて MCP サーバーの URL を入力します。

   https://your-project.your-username.workers.dev/sse
   

3. Playground のインターフェースを通じて、Google サービスとのやり取りを開始します

MCP Inspector を使ったオフラインテスト

Cloudflare にデプロイせずにローカルで開発およびテストするには、次の手順に従います。

1. プロジェクトのルートに .dev.vars ファイルを作成し、必要な環境変数を設定します。

   GOOGLE_OAUTH_CLIENT_ID="your-client-id"
   GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"
   COOKIE_ENCRYPTION_KEY="your-random-encryption-key"
   

2. Bun を使用します。

   # Install dependencies
   bun install
   
   # Run local development server
   bun run dev
   

3. MCP Inspector でテストします。

   bunx @modelcontextprotocol/inspector@latest
   

   ローカルインターフェースが起動し、MCP サーバーの機能をテストできます。

OAuth 認証

AI クライアントでサーバーを初めて使用する際は、Google アカウントへのアクセスを認証する必要があります。

1. サーバーに承認ダイアログが表示されます
2. MCP クライアントによるサーバーへのアクセスを承認します
3. Google OAuth フローに従って API アクセスを許可します
4. 認証後、AI クライアントにリダイレクトされます

ローカル開発

サーバーをローカルで実行するには、次のコマンドを実行します。

bun install
bun run dev

これによりローカル開発サーバーが起動します。通常は http://localhost:8788 で利用できます。

トラブルシューティング

• OAuth の問題：Google Cloud プロジェクトに正しいリダイレクト URI が設定されていることを確認してください
• API の権限：Google Cloud Console ですべての必須 API が有効になっていることを確認してください
• トークンの有効期限切れ：認証エラーが発生した場合は、KV ストレージを消去して再認証してください

Google MCP Remote をご利用いただきありがとうございます。ご質問やご提案がありましたら、お気軽に issue を作成するか、プロジェクトに貢献してください。