Gmail MCP Summarizer

📧 Gmail MCP摘要生成器

使用模型上下文协议 （MCP） 与 Gmail 交互的智能邮件助理。

🌟 产品特点

• ✅ 邮件Okuma自动提取来自特定发件人的邮件
• ✅ 发送邮件发送附加文件的邮件
• ✅ PDF 创建将文本内容转换为PDF（支持土耳其字符）
• ✅ 智能摘要使用Claude AI进行邮件摘要
• ✅ 自动回复使用 PDF 自动发送作业/报告

🎯 使用场景

1. 自动阅读老师的作业电子邮件
2. 与Claude总结作业要求
3. 作业完成后转换为PDF
4. 自动发回给老师

🛠️ 安装

要求

• Python 3.8+
• Gmail 帐户
• Claude 桌面应用程序
• 访问 Google Cloud Console

1. 克隆副本

git clone https://github.com/hasanoz07/mcp-gmail-summarizer.git
cd mcp-gmail-summarizer

2、创建虚拟环境

python3 -m venv venv
source venv/bin/activate  # Mac/Linux
# veya
venv\Scripts\activate  # Windows

3. 下载软件包

pip install -r requirements.txt

Google Cloud Console 设置

1. 谷歌云控制台 版本控制系统
2. 创建新工程
3. 启用 Gmail API
4. OAuth 2.0 Credentials（桌面应用程序）
5. credentials.json 下载文件并将其放入项目文件夹

5. 第一次身份验证

python test_gmail.py

浏览器将打开，允许您的Gmail帐户。

6. Claude 桌面配置

雨衣：

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

窗户：

%APPDATA%\Claude\claude_desktop_config.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
2. 太阳 高度🔨 点击图标
3. 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 → 发送邮件。

参数 ：

• contentPDF内容
• to_email买方地址：
• subject邮件主题
• pdf_titlePDF标题
• email_body邮件内容

🔐 安全

• credentials.json have的常用口语形式 token.pickle 文件 从来没有 不添加到 Git
• 使用OAuth2进行安全身份验证
• 只需要必要的权限（gmail.readonly + gmail.send）

🐛 解决问题

“没有名为‘reportlab’的模块”错误

pip install reportlab markdown2 Pillow

“服务器断开”错误

1. 检查 Claude Desktop 日志：

   tail -f ~/Library/Logs/Claude/mcp-server-gmail-summarizer.log

1. 手动测试 MCP 服务器：

   python3 gmail_mcp_server.py

看不到土耳其字符

pdf_generator.py 检查是否使用正确的字体。

📝 许可证

MIT许可证

👤 作者

哈桑·奥兹

• GitHub：\[@hasanoz07\]
• 电子邮件：hasanoz2002@gmail.com

🙏 找不到贡献

Pull请求欢迎！

1. 福克拉
2. 创建 Feature Branchgit checkout -b feature/amazing-feature)
3. 承诺(git commit -m 'Add amazing feature')
4. 普什拉(git push origin feature/amazing-feature)
5. 拉取请求aç

📚 参考资料

• 模型上下文协议（MCP）
• Gmail API
• 克劳德·艾
• 报告实验室