项目简介

ClaudePost 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在通过 Claude 桌面应用，使用自然语言与您的电子邮件账户进行交互。它允许您像与真人对话一样，轻松完成邮件的搜索、阅读、撰写和发送等任务，极大地提升了邮件管理的便捷性和效率。

主要功能点

邮件搜索与阅读:
- 通过日期范围和关键词快速搜索邮件。
- 查看每日邮件统计信息。
- 支持邮件线程，完整阅读邮件内容。
邮件撰写与发送:
- 支持抄送 (CC) 收件人。
- 安全处理邮件，使用 TLS 加密。

安装步骤

安装 uv: 按照仓库 README.md 中的指引安装 'uv' 包管理器。
克隆仓库: 使用 'git clone https://github.com/ZilongXue/claude-post.git' 命令克隆仓库到本地。
进入项目目录: 使用 'cd claude-post' 命令进入项目目录。
创建并激活虚拟环境: 运行 'uv venv' 创建虚拟环境，然后根据您的操作系统运行 'source .venv/bin/activate' (MacOS/Linux) 或 '.venv\Scripts\activate' (Windows) 激活虚拟环境。
安装依赖: 运行 'uv pip install -e .' 安装项目依赖。

配置 .env 文件: 在项目根目录下创建 '.env' 文件，并根据您的邮件服务商（例如 Gmail）填写以下配置信息：

[email protected]  # 您的邮箱地址
EMAIL_PASSWORD=your-app-specific-password # 您的应用专用密码 (强烈建议使用应用专用密码)
IMAP_SERVER=imap.gmail.com # IMAP 服务器地址 (Gmail 为 imap.gmail.com)
SMTP_SERVER=smtp.gmail.com # SMTP 服务器地址 (Gmail 为 smtp.gmail.com)
SMTP_PORT=587 # SMTP 端口 (通常为 587)

注意: 如果您使用 Gmail，请务必启用两步验证并生成应用专用密码，以提高安全性。

服务器配置 (Claude Desktop)

要将 ClaudePost 配置为 Claude Desktop 的 MCP 服务器，您需要编辑 Claude 的配置文件 'claude_desktop_config.json'。

配置文件路径:
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- 如果文件不存在，请手动创建。
配置内容: 在 'mcpServers' 字段下添加 'email' 服务器配置。请根据您的实际路径替换 '/path/to/claude-post' 和 'username'。
```
{
  "mcpServers": {
    "email": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/claude-post/src/email_client",
        "run",
        "email-client"
      ]
    }
  }
}
```
配置参数说明:
- 'server name': 'email' (服务器名称，在 Claude 中用于标识)
- 'command': '/Users/username/.local/bin/uv' (uv 包管理器的可执行文件路径，根据您的 uv 安装路径进行调整)
- 'args': 启动服务器的参数列表
  - '--directory': '/path/to/claude-post/src/email_client' (服务器代码所在的目录)
  - 'run': uv 的运行命令
  - 'email-client': 指定运行 'email_client' 包，对应 'src/email_client/main.py' 或 'src/email_client/init.py' 中的 'main' 函数。
配置完成后，重启 Claude Desktop 使配置生效。

基本使用方法

配置完成后，您可以通过 Claude Desktop 与您的邮件进行自然语言交互。以下是一些示例：

搜索邮件:
- "Show me emails from last week" (显示上周的邮件)
- "Find emails with subject containing 'meeting'" (查找主题包含 'meeting' 的邮件)
- "Search for emails from [email protected] between 2024-01-01 and 2024-01-07" (搜索 2024-01-01 到 2024-01-07 期间来自 [email protected] 的邮件)
- "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?" (HR 发来的最后一封邮件的完整内容是什么？)
邮件统计:
- "How many emails did I receive today?" (我今天收到了多少封邮件？)
- "Show me daily email counts for the past week" (显示过去一周每天的邮件数量)
发送邮件:
- "I want to send an email to [email protected]" (我想给 [email protected] 发送邮件)
- "Send a meeting confirmation to [email protected]" (给 [email protected] 发送会议确认邮件)
注意: 出于安全考虑，Claude 在实际发送邮件前会向您展示邮件详情以供确认。

日志

服务器运行日志会记录在 'email_client.log' 文件中，您可以查看此文件以获取调试信息和错误消息。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (Claude Desktop)

基本使用方法

日志

信息