Google MCP

🚀 Google MCP Server

Google MCP Serverは、統一APIを通じてGoogleのMaps、Finance、Flights、Gmail、Calendarなどのサービスにアクセスできる包括的なModel Context Protocol (MCP)サーバーです。

✨ 主な機能

🗺️ Google Maps & Places

• ジオコーディング：住所を座標に、または座標を住所に変換します。
• 場所検索：企業、ランドマーク、興味のある場所を検索します。
• ルート案内：場所間の逐次的なルート案内を取得します。
• 距離行列：複数の地点間の移動時間と距離を計算します。
• 場所の詳細情報：特定の場所に関する詳細情報を取得します。

📈 Google Finance

• 株式検索：株式、指数、投資信託、通貨、先物を検索します。
• 市場データ：現在の価格、変動、市場情報を取得します。
• 金融ニュース：証券に関連する主要な金融ニュースにアクセスします。

✈️ Google Flights

• 空港検索：フライトと空港情報を検索します。
• フライト価格：フライト価格と洞察を取得します。
• マルチシティ旅行：複雑な複数目的地の旅程をサポートします。

📧 Gmail

• メール送信：件名、本文、CC、BCCを含むメールを送信します。
• メール閲覧：Gmailのクエリ構文を使用してメールを一覧表示および検索します。
• メール詳細：メッセージIDで完全なメール内容を取得します。
• ラベル管理：Gmailのラベルと整理機能にアクセスします。

📅 Google Calendar

• イベント管理：カレンダーイベントの作成、閲覧、更新、削除を行います。
• 複数カレンダーサポート：複数のカレンダー（個人用、仕事用、旅行用など）で作業できます。
• イベント一覧：フィルターと日付範囲を指定してイベントを一覧表示します。
• カレンダー管理：異なるカレンダーを一覧表示し、アクセスします。

📦 インストール

前提条件

• Node.js 18+
• pnpm（推奨）またはnpm

セットアップ

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

   git clone <repository-url>
   cd google-mcp
   

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

   pnpm install
   

3. プロジェクトをビルドします：

   pnpm run build
   

MCPクライアントへの統合

好みのMCPクライアントにサーバーをインストールします：

# すべてのMCPクライアントにインストール
pnpm run install-server

# 特定のクライアントにインストール
pnpm run install-desktop    # Claude Desktop
pnpm run install-cursor     # Cursor IDE
pnpm run install-code       # Claude Code
pnpm run install-mcp        # ローカルの.mcp.jsonのみ

設定

環境変数

プロジェクトのルートに.env.localファイルを作成し、Google APIの認証情報を記述します：

GOOGLE_MAPS_API_KEY=your_google_maps_api_key
GOOGLE_CLIENT_ID=your_oauth_client_id
GOOGLE_CLIENT_SECRET=your_oauth_client_secret
GOOGLE_REFRESH_TOKEN=your_refresh_token

Google APIの設定

1. Google Maps API：Google Cloud ConsoleでMaps、Places、Directions APIを有効にします。
2. Gmail/Calendar：OAuth 2.0の認証情報を設定し、リフレッシュトークンを取得します。
3. Finance/Flights：Googleの公開APIを使用するため、追加の設定は必要ありません。

💻 使用例

サーバーの起動

# コンパイル済みのサーバーを起動
pnpm start

# または開発モードで実行
node dist/index.js

利用可能なツール

Maps & Places

• geocode - 住所を座標に変換
• reverse-geocode - 座標を住所に変換
• places-search - テキストクエリで場所を検索
• get-directions - 場所間のルートを取得
• distance-matrix - 複数の地点間の距離を計算
• place-details - 特定の場所の詳細情報を取得

Finance

• finance-search - 株式、通貨、金融商品を検索

Flights

• airports-search - フライトと空港情報を検索

Gmail

• gmail-send-email - メールを送信
• gmail-read-emails - メールを一覧表示/検索
• gmail-get-email - IDで特定のメールを取得
• gmail-get-labels - Gmailのラベルを一覧表示

Calendar

• calendar-create-event - 新しいイベントを作成
• calendar-list-events - フィルターでイベントを一覧表示
• calendar-get-event - 特定のイベントの詳細を取得
• calendar-update-event - 既存のイベントを更新
• calendar-delete-event - イベントを削除
• calendar-list-calendars - 利用可能なカレンダーを一覧表示

開発

プロジェクト構造

src/
├── index.ts       # メインのMCPサーバー実装
├── maps.ts        # Google Maps & Placesの機能
├── finance.ts     # Google Financeの統合
├── airports.ts    # Google Flightsの統合  
├── gmail.ts       # Gmail APIの統合
└── calendar.ts    # Google Calendarの統合

scripts/
└── update-config.js   # MCPクライアントの設定インストーラー

dist/             # コンパイルされたJavaScriptの出力

主要な技術

• MCP SDK：@modelcontextprotocol/sdkを使用したプロトコル実装
• スキーマ検証：ランタイム型チェックにZodを使用
• Google APIs：公式のGoogleクライアントライブラリ
• TypeScript：ES2022ターゲットで完全な型安全性
• トランスポート：MCP通信にStdioServerTransportを使用

開発ワークフロー

1. src/内のTypeScriptファイルに変更を加えます。
2. ビルド：pnpm run build
3. テスト：pnpm start
4. クライアントにインストール：pnpm run install-server
5. MCPクライアントを再起動して変更を反映します。

新しいツールの追加

1. パラメータのZodスキーマを定義します。
2. ハンドラー関数を実装します。
3. src/index.tsでserver.tool()を使用してツールを登録します。
4. ビルドして再インストールしてテストします。

アーキテクチャ

このMCPサーバーは以下の設計パターンに従っています：

• モジュール化設計：各Googleサービスは独自のモジュールに分かれています。
• スキーマ検証：すべてのパラメータはZodスキーマで検証されます。
• エラーハンドリング：意味のあるメッセージを持つ包括的なエラーハンドリングが行われます。
• 型安全性：Strictモードで完全なTypeScriptカバレッジがあります。
• トランスポート非依存：MCPの標準トランスポート層を使用しています。

📄 ライセンス

[License information]

コントリビュート

[Contribution guidelines]