Tencent Mail Agent MCP Server

這是一個基於 Model Context Protocol (MCP) 的伺服器，提供從 騰訊企業郵 (Tencent Exmail) 或任何支援 IMAP 協定的郵件服務中獲取並分析郵件的工具。此伺服器旨在與 Claude Desktop 等 MCP 客戶端配合使用。

功能特點

• list_yesterday_emails: 獲取昨天的郵件。
  • 自動依據日期範圍過濾（SINCE 昨天, BEFORE 今天）。
  • 回傳的 metadata 包含：UID、寄件者 (From)、主旨 (Subject)、日期 (Date) 以及內文片段 (snippet，前 500 個字元)。
  • 效能優化：預設限制獲取最新的 100 封郵件（可設定）。

前置需求

• Node.js (建議 v18 或更高版本)
• npm
• 騰訊企業郵帳號或任何 IMAP 帳號。

安裝步驟

1. 複製專案庫：

   git clone <repository-url>
   cd mail-agent-mcp
   

2. 安裝依賴套件：

   npm install
   

3. 編譯專案：

   npm run build
   

設定方法

1. 將 .env.example 複製並重新命名為 .env：

   cp .env.example .env
   

2. 編輯 .env 並提供您的郵件登入資訊：

   EMAIL_USER=your-email@example.com
   EMAIL_PASSWORD=your-app-password
   EMAIL_HOST=imap.exmail.qq.com
   EMAIL_PORT=993
   

   [!NOTE] 對於騰訊企業郵，如果您啟用了兩階段驗證 (2FA)，則需要使用 應用專用密碼 (App Password)。

使用方法

開發模式 (Development Mode)

npm run dev

正式模式 (Production Mode)

npm start

整合至 Claude Desktop

若要將此伺服器加入 Claude Desktop，請在您的 claude_desktop_config.json 中新增以下設定：

{
  "mcpServers": {
    "mail-agent": {
      "command": "node",
      "args": ["/絕對路徑/至/mail-agent-mcp/dist/index.js"],
      "env": {
        "EMAIL_USER": "your-email@example.com",
        "EMAIL_PASSWORD": "your-app-password",
        "EMAIL_HOST": "imap.exmail.qq.com",
        "EMAIL_PORT": "993"
      }
    }
  }
}

授權條款 (License)

ISC