Email Manager

🚀 ClaudePost 日本語版

ClaudePostは、モデルコンテキストプロトコル（MCP）サーバーです。Claudeとの自然言語対話を通じて、シームレスな電子メール管理インターフェースを提供します。この統合により、Claudeとの自然言語対話を通じて直接電子メールを処理でき、検索、閲覧、安全な送信などの機能がサポートされます。

🚀 クイックスタート

ClaudePostを使用するには、以下の手順に従ってください。

前提条件

• Python 3.12以上
• Gmailアカウント（またはその他のメールサービスプロバイダー）
• Gmailを使用する場合：
  • 二段階認証が有効になっている
  • アプリケーション固有のパスワードが生成されている
• Claudeデスクトップアプリケーション

インストール

1. uvをインストールします：

   # MacOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # インストール完了後、ターミナルを再起動してください
   

2. プロジェクトをクローンして設定します：

   # リポジトリをクローン
   git clone https://github.com/ZilongXue/claude-post.git
   cd claude-post
   
   # 仮想環境を作成してアクティブ化
   uv venv
   source .venv/bin/activate  # Windowsシステムの場合は：.venv\Scripts\activate
   
   # 依存関係をインストール
   uv pip install -e .
   

3. プロジェクトのルートディレクトリに.envファイルを作成します：

   EMAIL_ADDRESS=your.email@gmail.com
   EMAIL_PASSWORD=your-app-specific-password
   IMAP_SERVER=imap.gmail.com
   SMTP_SERVER=smtp.gmail.com
   SMTP_PORT=587
   

4. Claudeデスクトップを設定します：
   • Claude Desktopの設定画面を開きます。
   • プラグインまたは拡張機能の部分でClaudePost関連のオプションを有効にするか、設定します。
   • プロジェクトのパスをClaudeの環境変数に正しく追加してください。例えば：

     /your/project/path/claude-post
     

サーバーの起動

• Claudeを使用してサーバーを起動し、ネットワーク接続が正常であることを確認します。
• Claudeで自然言語コマンドを使用して、電子メールを検索、閲覧、送信するなどの操作を行います。

✨ 主な機能

電子メールの検索と閲覧

• 📧 日付範囲とキーワードで電子メールを検索
• 📅 毎日の電子メール統計情報を表示
• 📝 完全な電子メール内容を閲覧し、メールスレッドをサポート

電子メールの作成と送信

• ✉️ 同報（CC）をサポートした電子メール送信
• 🔒 TLSを使用した安全な電子メール処理

💻 使用例

基本的な使用法

メールの検索

今日の朝受け取ったメールの内容を調べて。

メールの送信

张三にメールを送って、件名は「プロジェクト進捗報告」、内容は「最近のプロジェクトの進捗は順調です。関連する詳細に注意してください。」と書いて。

📚 ドキュメント

プロジェクト構造

ClaudePost/
├── email_client.py          # メール処理ロジック
├── config.py                # 設定パラメータの設定
└── log/                    # ログ記録用フォルダ
    └── email_client.log     # アプリケーションのログファイル

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

• 個人アカウントのパスワードの代わりに、アプリケーション固有のパスワードを使用してください。
• Gmailユーザーの場合：
  1. 二段階認証を有効にします。
  2. アプリケーションパスワードを生成します。
  3. .envファイルでこのパスワードを使用します。

ログ記録

アプリケーションは詳細な情報をemail_client.logファイルに記録します。デバッグ情報やエラーメッセージを取得するには、このファイルを確認してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。