Email MCP App

🚀 mcp-email-server

本項目是基於ai-zerolab的原始 mcp-email-server 進行的自定義增強項目，支持通過MCP服務器實現IMAP和SMTP功能。

• Github倉庫：https://github.com/ai-zerolab/mcp-email-server/
• 文檔：https://ai-zerolab.github.io/mcp-email-server/

🚀 快速開始

📦 安裝指南

手動安裝

我們建議使用 uv 來管理您的環境。

您可以嘗試運行 uvx mcp-email-server@latest ui 進行配置，並使用以下配置用於mcp客戶端：

{
  "mcpServers": {
    "zerolib-email": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"]
    }
  }
}

這個包可以在PyPI上獲取，您可以使用 pip install mcp-email-server 進行安裝。

安裝完成後，使用 mcp-email-server ui 配置您的電子郵件服務器。

環境變量配置

您也可以使用環境變量來配置電子郵件服務器，這對於像Jenkins這樣的CI/CD環境特別有用。zerolib-email支持UI配置（通過TOML文件）和環境變量，其中環境變量具有更高的優先級。

{
  "mcpServers": {
    "zerolib-email": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"],
      "env": {
        "MCP_EMAIL_SERVER_ACCOUNT_NAME": "work",
        "MCP_EMAIL_SERVER_FULL_NAME": "John Doe",
        "MCP_EMAIL_SERVER_EMAIL_ADDRESS": "john@example.com",
        "MCP_EMAIL_SERVER_USER_NAME": "john@example.com",
        "MCP_EMAIL_SERVER_PASSWORD": "your_password",
        "MCP_EMAIL_SERVER_IMAP_HOST": "imap.gmail.com",
        "MCP_EMAIL_SERVER_IMAP_PORT": "993",
        "MCP_EMAIL_SERVER_SMTP_HOST": "smtp.gmail.com",
        "MCP_EMAIL_SERVER_SMTP_PORT": "465"
      }
    }
  }
}

可用的環境變量

啟用附件下載

出於安全原因，默認情況下禁用電子郵件附件下載。要啟用此功能，您可以選擇以下任一方法：

選項1：使用環境變量

{
  "mcpServers": {
    "zerolib-email": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"],
      "env": {
        "MCP_EMAIL_SERVER_ENABLE_ATTACHMENT_DOWNLOAD": "true"
      }
    }
  }
}

選項2：使用TOML配置 在您的TOML配置文件（~/.config/zerolib/mcp_email_server/config.toml）中添加 enable_attachment_download = true：

enable_attachment_download = true

[[emails]]
# ... 您的電子郵件配置

啟用後，您可以使用 download_attachment 工具將電子郵件附件保存到指定路徑。

將已發送的郵件保存到IMAP已發送文件夾

默認情況下，已發送的郵件會自動保存到您的IMAP已發送文件夾。這確保了通過MCP服務器發送的郵件會出現在您的電子郵件客戶端（如Thunderbird、網頁郵箱等）中。

服務器會自動檢測常見的已發送文件夾名稱：Sent、INBOX.Sent、Sent Items、Sent Mail、[Gmail]/Sent Mail。

指定自定義已發送文件夾名稱（適用於具有非標準文件夾名稱的提供商）：

選項1：使用環境變量

{
  "mcpServers": {
    "zerolib-email": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"],
      "env": {
        "MCP_EMAIL_SERVER_SENT_FOLDER_NAME": "INBOX.Sent"
      }
    }
  }
}

選項2：使用TOML配置

[[emails]]
account_name = "work"
save_to_sent = true
sent_folder_name = "INBOX.Sent"
# ... 您的其餘電子郵件配置

禁用保存到已發送文件夾，在您的TOML配置中設置 MCP_EMAIL_SERVER_SAVE_TO_SENT=false 或 save_to_sent = false。

對於單獨的IMAP/SMTP憑證，您還可以使用：

• MCP_EMAIL_SERVER_IMAP_USER_NAME / MCP_EMAIL_SERVER_IMAP_PASSWORD
• MCP_EMAIL_SERVER_SMTP_USER_NAME / MCP_EMAIL_SERVER_SMTP_PASSWORD

然後您可以在 Claude Desktop 中進行測試。如果您想將其與其他mcp客戶端集成，運行 $which mcp-email-server 獲取路徑，並在您的客戶端中進行如下配置：

{
  "mcpServers": {
    "zerolib-email": {
      "command": "{{ ENTRYPOINT }}",
      "args": ["stdio"]
    }
  }
}

如果 docker 可用，您可以嘗試使用docker鏡像，但您可能需要通過 MCP 使用 tools 在客戶端中進行配置。默認配置路徑為 ~/.config/zerolib/mcp_email_server/config.toml

{
  "mcpServers": {
    "zerolib-email": {
      "command": "docker",
      "args": ["run", "-it", "ghcr.io/ai-zerolab/mcp-email-server:latest"]
    }
  }
}

通過Smithery安裝

要通過 Smithery 自動為Claude Desktop安裝電子郵件服務器，請運行以下命令：

npx -y @smithery/cli install @ai-zerolab/mcp-email-server --client claude

💻 使用示例

回覆電子郵件

要正確地回覆電子郵件（以便在電子郵件客戶端中顯示在同一對話中）：

1. 首先，獲取原始電子郵件以獲取其 message_id：

emails = await get_emails_content(account_name="work", email_ids=["123"])
original = emails.emails[0]

2. 使用 in_reply_to 和 references 發送回覆：

await send_email(
    account_name="work",
    recipients=[original.sender],
    subject=f"Re: {original.subject}",
    body="Thank you for your email...",
    in_reply_to=original.message_id,
    references=original.message_id,
)

in_reply_to 參數設置 In-Reply-To 頭，references 設置 References 頭。這兩個頭都用於幫助電子郵件客戶端正確地組織對話。

🔧 開發

本項目使用 uv 進行管理。

您可以嘗試運行 make install 來安裝虛擬環境並安裝預提交鉤子。

使用 uv run mcp-email-server 進行本地開發。

🚀 發佈新版本

• 在 PyPI 上創建一個API令牌。
• 通過訪問 此頁面，將API令牌添加到您項目的密鑰中，名稱為 PYPI_TOKEN。
• 在Github上創建一個 新的版本。
• 創建一個格式為 *.*.* 的新標籤。

更多詳細信息，請參閱 此處。