Claude Post

🚀 ClaudePost

ClaudePost 是一個模型上下文協議（MCP）服務器，它通過 Claude 提供無縫的電子郵件管理界面。這種集成使你能夠通過與 Claude 進行自然語言對話直接處理電子郵件，安全地支持搜索、閱讀和發送電子郵件等功能。

✨ 主要特性

郵件搜索與閱讀

• 📧 按日期範圍和關鍵詞搜索郵件
• 📅 查看每日郵件統計信息
• 📝 閱讀完整郵件內容，並支持線程查看

郵件撰寫與發送

• ✉️ 支持抄送收件人發送郵件
• 🔒 通過 TLS 安全處理郵件

📦 安裝指南

前提條件

• 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 桌面應用。你可以從 這裡 安裝最新版本。如果你已經安裝了 Claude 桌面應用，請確保它是最新版本。

   打開你的 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 使用

你可以使用自然語言命令與你的電子郵件進行交互。以下是一些示例：

搜索郵件

• "Show me emails from last week"（顯示我上週的郵件）
• "Find emails with subject containing 'meeting'"（查找主題包含“會議”的郵件）
• "Search for emails from recruiting@linkedin.com between 2024-01-01 and 2024-01-07"（搜索 2024 年 1 月 1 日至 2024 年 1 月 7 日來自 recruiting@linkedin.com 的郵件）
• "Search sent emails from last month"（搜索上個月發出的郵件）

閱讀郵件內容

• "Show me the content of email #12345"（顯示郵件 #12345 的內容）
• "What's the full message of the last email from HR?"（人力資源部門最後一封郵件的完整內容是什麼？）

郵件統計

• "How many emails did I receive today?"（我今天收到了多少封郵件？）
• "Show me daily email counts for the past week"（顯示我過去一週的每日郵件數量）

發送郵件

• "I want to send an email to john@example.com"（我想給 john@example.com 發送一封郵件）
• "Send a meeting confirmation to team@company.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 文件。