MCP Mail Server

🚀 MCP郵件服務器

MCP郵件服務器是一個用於IMAP/SMTP郵件操作的模型上下文協議服務器，可與Claude、Cursor等AI助手協同工作，幫助用戶更便捷地管理和操作郵件。

🚀 快速開始

1. 安裝：使用命令 npm install -g mcp-mail-server 進行全局安裝。
2. 配置：配置環境變量（詳見 配置說明）。
3. 添加：將其添加到你的MCP客戶端配置中。
4. 使用：通過自然語言指令操作，例如 "Show me unread emails from today"。

✨ 主要特性

• IMAP操作：可在多個郵箱中搜索、讀取和管理郵件。
• SMTP支持：支持發送包含HTML或純文本內容以及附件的郵件。
• 安全配置：基於環境變量進行設置，支持TLS/SSL加密。
• AI友好：支持使用自然語言命令進行郵件操作。
• 自動連接管理：自動處理IMAP和SMTP連接。
• 多郵箱支持：可訪問收件箱、已發送郵件和自定義文件夾。

📦 安裝指南

Claude桌面版

在 claude_desktop_config.json 文件中添加以下配置：

{
  "mcpServers": {
    "mcp-mail-server": {
      "command": "npx",
      "args": ["mcp-mail-server"],
      "env": {
        "IMAP_HOST": "your-imap-server.com",
        "IMAP_PORT": "993",
        "IMAP_SECURE": "true",
        "SMTP_HOST": "your-smtp-server.com",
        "SMTP_PORT": "465",
        "SMTP_SECURE": "true",
        "EMAIL_USER": "your-email@domain.com",
        "EMAIL_PASS": "your-password"
      }
    }
  }
}

Cursor

在Cursor的MCP設置中添加以下配置：

{
  "mcpServers": {
    "mcp-mail-server": {
      "command": "npx",
      "args": ["mcp-mail-server"],
      "env": {
        "IMAP_HOST": "your-imap-server.com",
        "IMAP_PORT": "993",
        "IMAP_SECURE": "true",
        "SMTP_HOST": "your-smtp-server.com",
        "SMTP_PORT": "465",
        "SMTP_SECURE": "true",
        "EMAIL_USER": "your-email@domain.com",
        "EMAIL_PASS": "your-password"
      }
    }
  }
}

其他MCP客戶端

進行全局安裝：

npm install -g mcp-mail-server

然後進行如下配置：

{
  "mcpServers": {
    "mcp-mail-server": {
      "command": "mcp-mail-server"
    }
  }
}

📚 詳細文檔

可用工具

💻 使用示例

基礎用法

可以通過向AI助手輸入自然語言命令來操作郵件，例如：

• "Connect to my email servers"
• "Show me all unread emails"
• "Search for emails from boss@company.com"
• "Send an email to team@company.com about the meeting"
• "Reply to email with UID 123"

高級用法

• "Find emails with 'urgent' in the subject from last week"
• "Show me unreplied emails from boss@company.com"
• "Show me large emails over 5MB"
• "Get all emails from the Sales folder"

郵件管理

• "Delete the email with UID 123"
• "Mark recent emails as read"
• "List all my email folders"

🔧 技術細節

配置環境變量

⚠️ 重要提示

所有環境變量均為必填項。

常見郵箱提供商配置

安全注意事項

⚠️ 重要提示

• 建議啟用2FA並使用應用專用密碼。
• 始終使用安全連接（IMAP_SECURE=true，SMTP_SECURE=true）。
• 切勿在配置文件中硬編碼憑證信息。

本地開發設置

1. 克隆倉庫：

git clone https://github.com/yunfeizhu/mcp-mail-server.git
cd mcp-mail-server

2. 安裝依賴：

npm install

3. 構建項目：

npm run build

4. 設置環境變量：

export IMAP_HOST=your-imap-server.com
export IMAP_PORT=993
export IMAP_SECURE=true
export SMTP_HOST=your-smtp-server.com
export SMTP_PORT=465
export SMTP_SECURE=true
export EMAIL_USER=your-email@domain.com
export EMAIL_PASS=your-password

5. 啟動服務器：

npm start

📄 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE 文件。

包信息：

• 包名：mcp-mail-server
• Node.js版本：≥18.0.0
• 倉庫地址：GitHub
• 問題反饋：報告問題