ClaudePost

一个通过Claude提供无缝电子邮件管理界面的模型上下文协议（MCP）服务器。此集成允许您通过与Claude进行自然语言对话来处理电子邮件，支持搜索、阅读和安全发送电子邮件等功能。

功能与演示

邮件搜索与阅读

<p align="center"> <img src="assets/gif1.gif" width="800"/> </p>

• 📧 按日期范围和关键词搜索邮件
• 📅 查看每日邮件统计
• 📝 阅读完整的邮件内容，并支持线程查看

邮件撰写与发送

<p align="center"> <img src="assets/gif2.gif" width="800"/> </p>

• ✉️ 发送带有抄送人的邮件
• 🔒 使用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桌面自动运行：

• 如果配置正确，当启动Claude时，服务器会自动启动
• 不需要手动管理服务器
• 当关闭Claude时，服务器也会停止

通过Claude使用

您可以使用自然语言命令与您的电子邮件互动。这里有一些示例：

搜索邮件

• "显示我上周收到的邮件"
• "查找主题中包含'meeting'的邮件"
• "搜索2024年1月1日至2024年1月7日之间来自recruiting@linkedin.com的邮件"
• "搜索上个月发出的邮件"

阅读邮件内容

• "显示邮件#12345的内容"
• "HR发来的最后一封邮件的完整内容是什么？"

邮件统计

• "今天我收到了多少封邮件？"
• "显示过去一周每天的邮件数量"

发送邮件

• "我想给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文件。 </中文翻译>