邮件MCP网桥
> 通过模型上下文协议(MCP)将macOS Mail连接到AI
邮件MCP网桥 使AI助手(如Claude、ChatGPT)能够直接访问和分析您的macOS Mail电子邮件。只需从Mail复制一个邮件ID并将其粘贴到AI上,就不需要手动导出电子邮件。
演示:亲眼目睹 (点击观看)
显示:从邮件中复制邮件ID→ AI分析电子邮件内容
🇨🇳 中文版
🎯 什么和为什么
问题:现实世界中的大部分沟通都是通过电子邮件进行的——项目合作、客户沟通、商业谈判、技术支持。手动导出电子邮件进行人工智能分析既繁琐又低效。
解决方案:Mail MCP Bridge让AI通过简单的工作流程直接读取您的电子邮件:
- 从邮件复制邮件ID(一个键盘快捷键)
- 粘贴到AI
- AI即时分析电子邮件内容
用例:
- 📋 通过电子邮件跟踪项目进度
- 💼 从业务通信中提取关键信息
- 🔍 总结长电子邮件对话
- 📊 提取结构化数据(需求、反馈、承诺)
- 🤝 查看对话历史记录
- 📎 分析电子邮件附件(发票、报告、文档)
✨ 特性
- 📧 直接访问 -AI通过MCP协议读取您的电子邮件
- 🧵 线程支持 -使用一个消息ID检索整个对话
- 📎 附件提取 -提取电子邮件附件以进行人工智能分析(PDF、文档、图像)
- 🎨 Claude代码插件 -用于智能电子邮件分析的预构建命令和技能
- ⚡ 快速 -毫秒级查询响应
- 🎯 清洁文本 -针对AI优化的文本提取(不包括HTML、嵌入式图像)
- 🔒 隐私第一 -在本地运行,电子邮件永远不会离开你的Mac
🚀 快速开始
先决条件
- macOS 12.0+(带邮件应用程序)
- Python 3.9+
- MCP兼容的人工智能助手(例如Claude Desktop)
安装```bash
Clone the repository
git clone https://github.com/fatbobman/mail-mcp-bridge.git
cd mail-mcp-bridge
Install MCP dependencies
pip3 install mcp
### 配置Claude桌面
1. **查找配置位置**:```bash
~/Library/Application Support/Claude/claude_desktop_config.json
- 编辑配置 (如果不存在则创建):```json
{
"mcpServers": {
"mail": {
"command": "python3",
"args": [
"/path/to/mail-mcp-bridge/src/mail_mcp_server.py"
]
}
}
}
**重要**:替换 `/path/to/mail-mcp-bridge` 根据您的实际项目路径。
**可选的**:配置附件临时目录(默认为 `/tmp/mail-mcp-attachments`):```json
{
"mcpServers": {
"mail": {
"command": "python3",
"args": [
"/path/to/mail-mcp-bridge/src/mail_mcp_server.py"
],
"env": {
"MAIL_ATTACHMENT_PATH": "/tmp"
}
}
}
}
- 重新启动克劳德桌面 (完全退出,然后重新打开)
安装Claude代码插件(可选但推荐)
邮件MCP包括即用型 Claude代码插件 提供智能电子邮件分析功能:
你得到了什么:
- 🎯 智能附件分析 -自动检测重要附件(发票、合同、税务文件)
- 🧵 线程跟踪 -跟踪电子邮件对话中的文档演变
- 🚀 3种分析模式 -快速/交互式/自动模式,优化代币使用
- 📋 动作项提取 -在电子邮件中查找截止日期和任务
安装:```bash
1. Add the Mail MCP plugin marketplace
/plugin marketplace add /path/to/mail-mcp-bridge/plugins
2. Install the attachment analyzer
/plugin install mail-attachment-analyzer@mail-mcp
3. Restart Claude Code
替换 `/path/to/mail-mcp-bridge` 使用您的实际安装路径。
**用法**:
安装后,插件会自动工作:```
You: Analyze this email
AI: [Automatically detects attachments and analyzes intelligently]
或使用手动命令:```
/mail-mcp:analyze-attachment
📖 **→ 插件文档**
### 设置邮件快速操作
在邮件应用程序中添加“复制邮件ID”按钮:
**步进**:
1. 打开 **自动操作** (`⌘ + Space`,类型“自动机”)
1. 创建新的 **快速操作**:
- File → New (`⌘ + N`)
- 选择“快速操作”
- 工作流接收当前: **没有输入**
- 在: **邮件.app**
1. 添加 **运行Shell脚本** 动作:
- 在左侧面板中搜索“运行Shell脚本”
- 拖动到工作流区域
- 外壳:\`/bin/bash\*\*
1. 复制脚本内容:```bash
cat automator_script.sh
将整个输出粘贴到Automator脚本区域
-
另存为 “复制邮件ID”
-
(可选)指定键盘快捷键:
- 系统设置→ 键盘→ 键盘快捷键
- 服务→ Mail → “复制邮件ID”
- 添加快捷方式(例如。,
⌘ + ⇧ + C)
自动机设置示例:
测试IT:
- 打开邮件应用程序
- 选择任何电子邮件
- 按键盘快捷键(如果已配置)
- 您应该听到一个声音,确认邮件ID已复制
📖 用法
基本工作流程```
- Select email in Mail
- Press your keyboard shortcut (e.g., ⌘⇧C)
- Paste Message-ID to AI
### 对话示例
**阅读单个电子邮件**:```
You: Please analyze this email:
AI: I'll read that email for you...
[AI reads and analyzes the email content]
阅读电子邮件主题:```
You: What's the full conversation for ?
AI: I'll retrieve the entire thread...
[AI shows all emails in the conversation]
**真实世界用例**:```
You: Please summarize all communication with our business partner,
including their requirements, promised timelines, and action items.
AI: I'll read the relevant email threads and extract key information...
[AI analyzes email content, organizes project progress, commitments, and action items]
提取电子邮件附件:```text
You: Extract and analyze the PDF invoice from this email:
AI: I can see this email has an invoice.pdf attachment (1.2MB). Let me extract it...
[AI extracts attachment and analyzes the content]
## 🛠️ MCP工具
|工具|说明|
|------|-------------|
| `get_email_path` |获取单个电子邮件文件路径|
| `get_thread_paths` |获取电子邮件线程中的所有路径|
| `read_email` |读取单个电子邮件内容(包括附件元数据)|
| `read_thread` |阅读整个电子邮件线程|
| `extract_attachments` |从电子邮件中提取特定附件|
| `cleanup_attachments` |清理临时附件文件|
📖 **→ API详细文档**
## 🏗️ 运作原理```
┌─────────────┐
│ Mail App │ Select email → Copy Message-ID (⌘⇧C)
└──────┬──────┘
│
↓ Message-ID
┌─────────────┐
│MCP Server │ 1. Query Mail SQLite database
│ │ 2. Locate .emlx file by ROWID
│ │ 3. Parse email content
│ │ 4. Extract plain text
└──────┬──────┘
│
↓ Structured Data
┌─────────────┐
│ AI Assistant│ Analyze email content
└─────────────┘
🔧 → 技术架构
🐛 故障排除
未找到MCP服务器
解决方案:```bash
Verify the path in claude_desktop_config.json
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json
Restart Claude Desktop (quit completely, then reopen)
### 未找到电子邮件
**可能的原因**:
1. 消息ID格式不正确(必须包括 `< >`)
1. 已从邮件中删除电子邮件
1. 不同邮件帐户数据库中的电子邮件
### 权限不足
**解决方案**:```bash
# Make scripts executable
chmod +x *.py *.sh
🔒 隐私和安全
- ✅ 本地处理:所有操作都在Mac上本地运行
- ✅ 无外部服务器:没有数据发送到外部服务器
- ✅ 无遥测:无分析或跟踪
- ✅ 只读的:只读取电子邮件数据,从不修改
📚 文档
- TOOLS.md -所有MCP工具的完整API参考资料
- 建筑.md -技术架构和数据库结构
- README_zh.md - 中文文档
📝 许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
🤝 贡献
欢迎投稿!请随时提交拉取请求。
🌟 致谢
- 为MCP(模型上下文协议)生态系统构建
- 受到连接电子邮件和人工智能需求的启发
- 在macOS 26(Tahoe)上使用Claude Desktop进行测试
📮 联系
- 问题:
- 作者:胖子(徐阳)
☕ 给我买杯咖啡
如果你觉得这个项目有帮助,可以考虑给我买杯咖啡!
由以下材料制成❤️ 对于AI社区
