ClaudePost

一个通过Claude提供无缝邮件管理界面的模型上下文协议（MCP）服务器。此集成允许您直接通过与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 Desktop：

   首先，确保已安装了适用于桌面的Claude。您可以从这里下载最新版本。如果您已经安装了适用于桌面的Claude，请确保其更新到了最新版本。

   打开您的Claude Desktop配置文件：

   # 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 Desktop以使更改生效。

运行服务器

服务器通过Claude Desktop自动运行：

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

通过 Claude 使用

您可以使用自然语言命令与您的电子邮件进行交互。以下是一些示例：

搜索邮件

• "显示上周的邮件"
• "查找主题包含 'meeting' 的邮件"
• "搜索从 recruiting@linkedin.com 在 2024-01-01 到 2024-01-07 之间的邮件"
• "搜索上个月发送的邮件"

阅读邮件内容

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

邮件统计

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

发送邮件

• "我想给 john@example.com 发一封邮件"
• "给 team@company.com 发送一个会议确认"

注意：出于安全考虑，Claude 在实际发送之前总是会显示邮件详情以供确认。

项目结构

claude-post/
├── pyproject.toml
├── README.md
├── LICENSE
├── .env                    # Not included in repo
├── .python-version        # Python version specification
└── src/
    └── email_client/
        ├── __init__.py
        ├── __main__.py
        └── server.py       # Main implementation

安全注意事项

• 使用应用程序特定密码而不是您的主账户密码
• 对于 Gmail 用户：
  1. 在您的 Google 账户中启用两步验证
  2. 为此应用程序生成一个应用密码
  3. 在您的 .env 文件中使用该应用密码

日志

应用程序会将详细信息记录到 email_client.log 文件中。请检查此文件以获取调试信息和错误消息。

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。