MCP Gmail

🚀 MCP 統合サーバー

このリポジトリには、様々なサービスをClaude Desktopと統合するためのModel Control Protocol (MCP) サーバーが含まれています。

🚀 クイックスタート

このMCP統合サーバーを使用することで、Claude Desktopと様々なサービスを連携させることができます。以下に、GmailとGoogle Calendar、およびバックエンドAPIの統合に関する詳細を説明します。

✨ 主な機能

GmailとGoogle Calendar MCPサーバー

GmailとGoogle Calendarの統合により、ClaudeはあなたのGmailアカウントとGoogle Calendarとやり取りし、電子メール管理やカレンダー操作を行うことができます。

• Gmail操作：
  • 受信トレイの最新のメールを取得
  • Gmailクエリ構文を使用してメールを検索
  • 電子メールの内容を表示
  • CCとBCCをサポートした電子メールの送信
• カレンダー操作：
  • カレンダーイベントを検索
  • 新しいカレンダーイベントを作成
  • 今後のイベントを表示

バックエンドAPI MCPサーバー

バックエンドAPI MCPサーバーは、カスタムバックエンドAPIをClaude Desktopに統合するためのテンプレートを提供します。

• ユーザー管理操作
• 標準化されたAPIレスポンス
• エラー処理とログ記録
• Pydanticモデルを使用したデータ検証

📦 インストール

GmailとGoogle Calendar MCPサーバー

1. 前提条件：
   • Python 3.x
   • MCPパッケージがインストールされていること
   • Google Cloud ConsoleプロジェクトでGmailとCalendar APIが有効になっていること
2. OAuth認証情報：
   • Google Cloud Consoleにアクセス
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択
   • Gmail APIとGoogle Calendar APIを有効にする
   • OAuth 2.0認証情報を作成
   • 認証情報をダウンロードし、プロジェクトディレクトリにcredentials.jsonとして保存
3. インストール：

   # 必要なパッケージをインストール
   pip install google-auth-oauthlib google-auth-httplib2 google-api-python-client
   
   # Claude Desktopにサーバーをインストール
   mcp install server.py
   

4. 初回実行：
   • サーバーを実行：mcp run server.py
   • 初回実行時にはOAuth認証が求められます
   • ブラウザのリンクに従ってアプリケーションを承認
   • トークンは次回使用するために保存されます

バックエンドAPI MCPサーバー

1. 前提条件：
   • Python 3.x
   • MCPパッケージがインストールされていること
2. インストール：

   # 必要なパッケージをインストール
   pip install pydantic
   
   # Claude Desktopにサーバーをインストール
   mcp install backend_server.py
   

3. 設定：
   • backend_server.pyで必要に応じてAPIエンドポイントやその他の設定を構成

💻 使用例

Gmailツール

# 受信トレイの最新のメールを取得
get_latest_emails(max_results: int = 10)

# Gmailクエリを使用してメールを検索
search_emails(query: str, max_results: int = 10)

# 特定の電子メールの内容を表示
get_email_content(email_id: str)

# 電子メールを送信
send_email(to: str, subject: str, body: str, cc: Optional[str], bcc: Optional[str])

Calendarツール

# カレンダーイベントを検索
search_events(query: str, max_results: int = 10, time_min: Optional[str])

# 新しいカレンダーイベントを作成
create_calendar_event(summary: str, start_time: str, end_time: str, description: Optional[str], location: Optional[str])

📚 ドキュメント

開発に関する説明

• 特定のニーズに合わせてコードを変更
• 機能を拡張するか、新しいAPIサポートを追加
• MCPプロトコルを使用して通信

セキュリティに関する注意事項

• 認証情報やその他の機密情報を安全に保管すること
• 公開リポジトリに機密データを保存しないこと
• 定期的にアクセス権限を更新し管理すること

よくある質問

• エラーはどのように処理すればよいですか？ドキュメントのエラー処理のセクションを参照してください。
• 他のAPIはサポートされていますか？はい、より多くのサービスをサポートするように拡張できます。
• パフォーマンスを最適化するにはどうすればよいですか？キャッシュメカニズムと効率的なコード設計を使用することをおすすめします。

📄 ライセンス

本READMEにはライセンス情報が記載されていません。

おわりに

MCP統合サーバーをご利用いただき、ありがとうございます。詳細な情報は、完全なドキュメントを参照するか、サポートチームにお問い合わせください。