Claude Post

🚀 ClaudePost

ClaudePostは、Claudeを通じてシームレスなメール管理インターフェースを提供するモデルコンテキストプロトコル（MCP）サーバーです。この統合により、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 for Desktopがインストールされていることを確認してください。最新バージョンはこちらからインストールできます。既にClaude for Desktopを持っている場合は、最新バージョンに更新してください。 Claudeデスクトップの設定ファイルを開きます。

   # MacOS
   ~/Library/Application Support/Claude/claude_desktop_config.json
   
   # ファイルが存在しない場合は作成する
   mkdir -p ~/Library/Application\ Support/Claude
   touch ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

   以下の設定を追加します。

   {
     "mcpServers": {
       "email": {
         "command": "/Users/username/.local/bin/uv",
         "args": [
           "--directory",
           "/path/to/claude-post/src/email_client",
           "run",
           "email-client"
         ]
       }
     }
   }
   

   /Users/usernameと/path/to/claude-postを実際のパスに置き換えてください。 設定を更新した後、Claudeデスクトップを再起動して変更を有効にします。

サーバーの起動

サーバーはClaudeデスクトップを通じて自動的に起動します。

• 正しく設定されている場合、Claudeを起動するとサーバーが開始されます。
• 手動でのサーバー管理は必要ありません。
• Claudeを閉じるとサーバーが停止します。

✨ 主な機能

メールの検索と閲覧

• 📧 日付範囲とキーワードでメールを検索する
• 📅 日々のメール統計を表示する
• 📝 スレッドサポート付きでメールの全文を読む

メールの作成と送信

• ✉️ CC受信者をサポートしたメールを送信する
• 🔒 TLSによる安全なメール処理

💻 使用例

Claudeを通じて自然言語コマンドを使用してメールと対話できます。以下はいくつかの例です。

メールの検索

• "先週のメールを表示して"
• "件名に'会議'が含まれるメールを探す"
• "2024年1月1日から2024年1月7日までのrecruiting@linkedin.comからのメールを検索する"
• "先月送信したメールを検索する"

メール内容の閲覧

• "メール#12345の内容を表示して"
• "HRからの最後のメールの全文は何ですか？"

メール統計

• "今日受信したメールは何通ですか？"
• "過去1週間の日々のメール数を表示して"

メールの送信

• "john@example.comにメールを送りたい"
• "team@company.comに会議の確認メールを送信する"

注: セキュリティ上の理由から、Claudeは実際に送信する前に常にメールの詳細を表示して確認を求めます。

📚 ドキュメント

プロジェクト構造

claude-post/
├── pyproject.toml
├── README.md
├── LICENSE
├── .env                    # リポジトリに含まれません
├── .python-version        # Pythonバージョン指定
└── src/
    └── email_client/
        ├── __init__.py
        ├── __main__.py
        └── server.py       # メイン実装

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

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

ロギング

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

📄 ライセンス

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