Mail MCP Bridge

🚀 郵件MCP橋接器

郵件MCP橋接器通過模型上下文協議（MCP）將macOS郵件應用與人工智能連接起來，讓AI助手（如Claude、ChatGPT）直接訪問和分析你的郵件，無需手動導出郵件，只需從郵件中複製Message-ID並粘貼到AI即可。

🚀 快速開始

前提條件

• macOS 12.0 及以上版本（需安裝郵件應用）
• Python 3.9 及以上版本
• 支持MCP的AI助手（如Claude Desktop）

安裝

# 克隆倉庫
git clone https://github.com/fatbobman/mail-mcp-bridge.git
cd mail-mcp-bridge

# 安裝MCP依賴
pip3 install mcp

配置Claude Desktop

1. 查找配置文件位置：

~/Library/Application Support/Claude/claude_desktop_config.json

2. 編輯配置文件（若文件不存在則創建）：

{
  "mcpServers": {
    "mail": {
      "command": "python3",
      "args": [
        "/path/to/mail-mcp-bridge/src/mail_mcp_server.py"
      ]
    }
  }
}

重要提示：請將/path/to/mail-mcp-bridge替換為你實際的項目路徑。

可選配置：配置附件臨時目錄（默認為/tmp/mail-mcp-attachments）：

{
  "mcpServers": {
    "mail": {
      "command": "python3",
      "args": [
        "/path/to/mail-mcp-bridge/src/mail_mcp_server.py"
      ],
      "env": {
        "MAIL_ATTACHMENT_PATH": "/tmp"
      }
    }
  }
}

3. 重啟Claude Desktop（完全退出後重新打開）

安裝Claude代碼插件（可選但推薦）

郵件MCP包含了現成的Claude代碼插件，可提供智能郵件分析功能： 功能特性：

• 🎯 智能附件分析 - 自動檢測重要附件（發票、合同、稅務文件等）
• 🧵 線程跟蹤 - 跟蹤郵件對話中的文檔演變
• 🚀 三種分析模式 - 快速/交互/自動模式，優化令牌使用
• 📋 行動項提取 - 查找郵件中的截止日期和任務

安裝步驟：

# 1. 添加郵件MCP插件市場
/plugin marketplace add /path/to/mail-mcp-bridge/plugins

# 2. 安裝附件分析器
/plugin install mail-attachment-analyzer@mail-mcp

# 3. 重啟Claude代碼

請將/path/to/mail-mcp-bridge替換為你實際的安裝路徑。

使用方法： 安裝後，插件將自動工作：

你：分析這封郵件 <message-id@example.com>
AI：[自動檢測附件並進行智能分析]

也可使用手動命令：

/mail-mcp:analyze-attachment

📖 → 插件文檔

設置郵件快速操作

在郵件應用中添加“複製Message-ID”按鈕： 詳細步驟：

1. 打開自動操作（⌘ + Space，輸入“自動操作”）
2. 創建新的快速操作：
   • 文件 → 新建（⌘ + N）
   • 選擇“快速操作”
   • 工作流程接收當前：無輸入
   • 在：郵件.app
3. 添加運行Shell腳本操作：
   • 在左側面板中搜索“運行Shell腳本”
   • 拖到工作流程區域
   • 外殼：/bin/bash
4. 複製腳本內容：

cat automator_script.sh

將整個輸出粘貼到自動操作腳本區域 5. 保存為**“複製Message-ID”** 6. （可選）分配鍵盤快捷鍵： - 系統設置 → 鍵盤 → 鍵盤快捷鍵 - 服務 → 郵件 → “複製Message-ID” - 添加快捷鍵（如⌘ + ⇧ + C）

自動操作設置示例：

測試方法：

1. 打開郵件應用
2. 選擇任意郵件
3. 按下你的鍵盤快捷鍵（如果已配置）
4. 你應該會聽到確認Message-ID已複製的聲音

✨ 主要特性

• 📧 直接訪問 - AI通過MCP協議讀取你的郵件
• 🧵 線程支持 - 使用一個Message-ID檢索整個對話
• 📎 附件提取 - 提取郵件附件供AI分析（PDF、文檔、圖像等）
• 🎨 Claude代碼插件 - 預構建的命令和技能，用於智能郵件分析
• ⚡ 快速響應 - 毫秒級查詢響應
• 🎯 純淨文本 - 為AI優化文本提取（排除HTML、嵌入式圖像）
• 🔒 隱私至上 - 本地運行，郵件不會離開你的Mac

📦 安裝指南

安裝步驟已在快速開始部分詳細介紹，這裡不再贅述。

💻 使用示例

基礎用法

1. 在郵件中選擇郵件
2. 按下你的鍵盤快捷鍵（如⌘⇧C）
3. 將Message-ID粘貼到AI

示例對話

讀取單封郵件：

你：請分析這封郵件：<message-id@example.com>
AI：我將為你讀取那封郵件...
[AI讀取並分析郵件內容]

讀取郵件線程：

你：<message-id@example.com>的完整對話是什麼？
AI：我將檢索整個對話...
[AI顯示對話中的所有郵件]

實際應用場景：

你：請總結與我們商業夥伴的所有溝通，包括他們的要求、承諾的時間表和行動項。
AI：我將讀取相關郵件線程並提取關鍵信息...
[AI分析郵件內容，整理項目進度、承諾和行動項]

提取郵件附件：

你：從這封郵件中提取並分析PDF發票：<message-id@example.com>
AI：我看到這封郵件有一個invoice.pdf附件（1.2MB）。讓我提取它...
[AI提取附件並分析內容]

📚 詳細文檔

MCP工具

📖 → 詳細API文檔

🔧 技術細節

工作原理

┌─────────────┐
│ 郵件應用   │ 選擇郵件 → 複製Message-ID（⌘⇧C）
└──────┬──────┘
       │
       ↓ Message-ID
┌─────────────┐
│MCP服務器   │ 1. 查詢郵件SQLite數據庫
│             │ 2. 通過ROWID定位.emlx文件
│             │ 3. 解析郵件內容
│             │ 4. 提取純文本
└──────┬──────┘
       │
       ↓ 結構化數據
┌─────────────┐
│ AI助手     │ 分析郵件內容
└─────────────┘

🔧 → 技術架構

🐛 故障排除

MCP服務器未找到

解決方案：

# 驗證claude_desktop_config.json中的路徑
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

# 重啟Claude Desktop（完全退出後重新打開）

郵件未找到

可能原因：

1. Message-ID格式不正確（必須包含< >）
2. 郵件已從郵件應用中刪除
3. 郵件位於不同的郵件賬戶數據庫中

權限被拒絕

解決方案：

# 使腳本可執行
chmod +x *.py *.sh

📄 許可證

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

🤝 貢獻

歡迎貢獻代碼！請隨時提交拉取請求。

🌟 致謝

• 為MCP（模型上下文協議）生態系統而構建
• 受連接郵件和AI需求的啟發
• 在macOS 26（Tahoe）上使用Claude Desktop進行測試

📮 聯繫信息

• 問題反饋：https://github.com/fatbobman/mail-mcp-bridge/issues
• 作者：Fatbobman（徐洋）

☕ 請我喝咖啡

如果你覺得這個項目有幫助，不妨請我喝杯咖啡！

為AI社區用心打造 ❤️