📧 Gmail MCP摘要生成器
使用模型上下文协议 (MCP) 与 Gmail 交互的智能邮件助理。
🌟 产品特点
- ✅ 邮件Okuma自动提取来自特定发件人的邮件
- ✅ 发送邮件发送附加文件的邮件
- ✅ PDF 创建将文本内容转换为PDF(支持土耳其字符)
- ✅ 智能摘要使用Claude AI进行邮件摘要
- ✅ 自动回复使用 PDF 自动发送作业/报告
🎯 使用场景
- 自动阅读老师的作业电子邮件
- 与Claude总结作业要求
- 作业完成后转换为PDF
- 自动发回给老师
🛠️ 安装
要求
- Python 3.8+
- Gmail 帐户
- Claude 桌面应用程序
- 访问 Google Cloud Console
1. 克隆副本```bash
git clone https://github.com/hasanoz07/mcp-gmail-summarizer.git
cd mcp-gmail-summarizer
### 2、创建虚拟环境```bash
python3 -m venv venv
source venv/bin/activate # Mac/Linux
# veya
venv\Scripts\activate # Windows
3. 下载软件包```bash
pip install -r requirements.txt
### Google Cloud Console 设置
1. 谷歌云控制台 版本控制系统
1. 创建新工程
1. 启用 Gmail API
1. OAuth 2.0 Credentials(桌面应用程序)
1. `credentials.json` 下载文件并将其放入项目文件夹
### 5. 第一次身份验证```bash
python test_gmail.py
浏览器将打开,允许您的Gmail帐户。
6. Claude 桌面配置
雨衣:```bash
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
**窗户:**```
%APPDATA%\Claude\claude_desktop_config.json
添加以下内容(按照自己的方式编辑路径):```json
{
"mcpServers": {
"gmail-summarizer": {
"command": "/PATH/mcp-gmail-summarizer/venv/bin/python3",
"args": [
"/PATH/mcp-gmail-summarizer/gmail_mcp_server.py"
]
}
}
}
### 启动 Claude Desktop
1. 打开 Claude Desktop
1. 太阳 高度🔨 点击图标
1. `gmail-summarizer` 必须是活跃的
## 📖 使用
### 邮件Okuma```
makale@example.com adresinden son 5 maili getir ve özetle
创建和发送PDF```
Şu metni PDF'e çevir ve hoca@example.com adresine gönder:
Ödev 1 - Python Temelleri
Bu ödevde Python'un temel konuları işlenmiştir.
Email konusu: "Ödev 1 Tamamlandı"
### 发送附加文件邮件```
hoca@example.com adresine /path/to/file.pdf dosyasını gönder
Konu: "Proje Raporu"
İçerik: "Raporumu ekte bulabilirsiniz."
🏗️ 项目结构```
mcp-gmail-summarizer/
├── gmail_mcp_server.py # MCP sunucu
├── gmail_fetcher.py # Gmail API işlemleri
├── pdf_generator.py # PDF oluşturucu
├── test_gmail.py # Gmail bağlantı testi
├── requirements.txt # Python bağımlılıkları
├── credentials.json # Google OAuth (gitignore'da)
├── token.pickle # Kimlik token (gitignore'da)
├── generated_pdfs/ # Oluşturulan PDF'ler
└── README.md # Bu dosya
## 🔧 MCP车辆
### 1. `get_emails_from_sender`
接收来自特定发件人的邮件。
**参数 :**
- `sender_email`发件人电子邮件地址
- `max_results`最大邮件数(默认:10)
### 2. `send_email_with_attachment`
发送邮件(可选附加)。
**参数 :**
- `to_email`买方地址:
- `subject`邮件主题
- `body`邮件内容
- `attachment_path`附加文件路径(可选)
### 3. `create_and_send_pdf`
文本 → PDF → 发送邮件。
**参数 :**
- `content`PDF内容
- `to_email`买方地址:
- `subject`邮件主题
- `pdf_title`PDF标题
- `email_body`邮件内容
## 🔐 安全
- `credentials.json` have的常用口语形式 `token.pickle` 文件 **从来没有** 不添加到 Git
- 使用OAuth2进行安全身份验证
- 只需要必要的权限(gmail.readonly + gmail.send)
## 🐛 解决问题
### “没有名为‘reportlab’的模块”错误```bash
pip install reportlab markdown2 Pillow
“服务器断开”错误
- 检查 Claude Desktop 日志:```bash
tail -f ~/Library/Logs/Claude/mcp-server-gmail-summarizer.log
2. 手动测试 MCP 服务器:```bash
python3 gmail_mcp_server.py
看不到土耳其字符
pdf_generator.py 检查是否使用正确的字体。
📝 许可证
MIT许可证
👤 作者
哈桑·奥兹
- GitHub:[@hasanoz07]
- 电子邮件:hasanoz2002@gmail.com
🙏 找不到贡献
Pull请求欢迎!
- 福克拉
- 创建 Feature Branch
git checkout -b feature/amazing-feature) - 承诺(
git commit -m 'Add amazing feature') - 普什拉(
git push origin feature/amazing-feature) - 拉取请求aç
📚 参考资料
- 模型上下文协议(MCP)
- Gmail API
- 克劳德·艾
- 报告实验室
