ClaudePost

クロード・ポスト

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

機能とデモ

メールの検索と閲覧

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

メールの作成と送信

• ✉️ CC受信者のサポート付きメール送信
• 🔒 TLSによる安全なメール処理

前提条件

• Python 3.12以上
• Gmailアカウント（または他のメールプロバイダー）
• Gmail を使用している場合:
  • 二要素認証が有効
  • アプリ固有のパスワードが生成されました
• クロードデスクトップアプリケーション

設定

1. uvをインストールします:
   # MacOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Remember to restart your terminal after installation
2. プロジェクトのクローンを作成してセットアップします。
   # Clone the repository git clone https://github.com/ZilongXue/claude-post.git cd claude-post # Create and activate virtual environment uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate # Install dependencies 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 Desktop 構成ファイルを開きます。
   # MacOS ~/Library/Application Support/Claude/claude_desktop_config.json # Create the file if it doesn't exist 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 Desktop を再起動します。

サーバーの実行

サーバーはClaude Desktopを通じて自動的に実行されます。

• 正しく設定されていれば、Claude の起動時にサーバーが起動します。
• 手動によるサーバー管理は不要
• クロードが閉じられるとサーバーが停止します

クロードを通じての使用

自然言語コマンドを使ってメールを操作できます。以下に例をいくつか示します。

メールを検索

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

メールの内容を読む

• 「メール #12345 の内容を見せてください」
• 「人事部からの最後のメールの全文は何ですか？」

メール統計

• 「今日は何通のメールを受け取りましたか？」
• 「過去1週間の毎日のメール数を表示」

メールを送信する

• 「 john@example.comにメールを送信したい」
• 「会議の確認をteam@company.comに送信してください」

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

プロジェクト構造

セキュリティノート

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

ログ記録

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

ライセンス

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