Gmail MCP Server 9of

🚀 Gmail MCP サーバー

強力で柔軟性の高いGmail統合サーバーで、メッセージ制御プロトコル (MCP) フレームワークを使用して構築されています。このサーバーは、Gmail APIとの強力なインターフェースを提供し、プログラムによるメールの読み取り、送信、管理をサポートします。

✨ 主な機能

• 複数のGmailアカウントからメールを読み取る
• 添付ファイル付きのメールを送信する
• 高度なクエリオプションを使用してメールを検索する
• メールの添付ファイルをダウンロードする
• メールの会話とスレッドを処理する
• メールをリアルタイムで監視する
• 複数のGmailアカウントをサポートする

📦 インストール

Smitheryを使用したインストール

Smithery を通じてGmail統合サーバーを自動的にインストールします：

npx -y @smithery/cli install @Quantum-369/Gmail-mcp-server --client claude

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

git clone <your-repository-url>
cd gmail-mcp-server

2. 仮想環境を作成してアクティブ化します：

python -m venv venv
# Windowsの場合
venv\Scripts\activate
# Unix/MacOSの場合
source venv/bin/activate

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

pip install .

📚 ドキュメント

Google Cloudプロジェクトの設定

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. プロジェクトのGmail APIを有効にします。
4. OAuth 2.0のクライアントID資格情報を作成します：
   • "APIs & Services" > "Credentials" に移動します。
   • "Create Credentials" > "OAuth client ID" をクリックします。
   • アプリケーションのタイプとして "Desktop app" を選択します。
   • クライアントの設定ファイルをダウンロードします。
5. ダウンロードしたファイルを client_secret.json にリネームし、プロジェクトのルートディレクトリに配置します。

設定

1. gmail_token_creator.py で電子メール識別子を設定します：

email_identifier = 'your.email@gmail.com'  # 各アカウントに合わせてこの値を変更します

2. トークン作成ツールを実行して、Gmailアカウントを認証します：

python gmail_token_creator.py

3. 統合する各Gmailアカウントに対して、上記の手順を繰り返します。

サーバー構造

• gmail_server.py：コアサーバーファイル
• settings.py：設定と構成
• templates/：HTMLテンプレートディレクトリ
• static/：静的リソースディレクトリ

使用方法

依存関係のインストール

pipを使用して必要なPythonパッケージをインストールします：

pip install -r requirements.txt

サーバーの起動

以下のコマンドを実行して、Gmail MCPサーバーを起動します：

python gmail_server.py

アプリケーションへのアクセス

ブラウザを開き、http://localhost:8000 にアクセスします。

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

• すべての機密ファイル（例：client_secret.json）を暗号化し、安全な場所に保管してください。
• 資格情報をバージョン管理システムにコミットしないでください。.gitignore ファイルに追加することができます。
• 機密情報をコードにハードコードするのではなく、環境変数を使用して管理してください。

エラー処理

ログ記録

サーバーは、操作の状態とエラー情報をログファイルに記録します。デフォルトでは、ログファイルは logs/ ディレクトリにあります。

デバッグ

settings.py のログレベル設定を確認して、出力の詳細度を調整してください。

貢献ガイド

リポジトリのクローン

git clone https://github.com/yourusername/gmail-mcp-server.git

変更のコミット

1. 機能ブランチを作成します：

git checkout -b feature/new-feature

2. 変更をコミットします：

git add .
git commit -m "新機能の追加"

3. オリジンにプッシュして、プルリクエストを作成します：

git push origin feature/new-feature

📄 ライセンス

このプロジェクトは MIT License の下で保護されています。

お問い合わせ

質問や提案がある場合は、contact@example.com にメールを送信するか、GitHubで問題を提出してください。