AI导哈

邮件智能助手

一个基于Gmail API和Claude AI的智能邮件助手，提供邮件自动读取、智能摘要、PDF生成及自动发送功能，适用于教育和工作场景。

  • by hasanoz07
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 hasanoz07/mcp-gmail-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