Gmail Paper Digest — Claude Code MCP Server

读取 Gmail「论文推送」标签下的学术推送邮件，生成每日论文日报。

功能

工具	用途
daily_paper_digest	过去 N 天论文推送日报（按来源分组）
search_paper_emails	搜索论文推送邮件列表
get_paper_email_detail	获取单封邮件完整正文
check_setup	检查 Gmail 连接与标签状态

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 获取 Google OAuth 凭证

1. Google Cloud Console → 新建项目
2. 启用 Gmail API（只读范围：gmail.readonly）
3. 创建 OAuth 2.0 客户端 ID（桌面应用）
4. 下载 JSON → 重命名为 credentials.json → 放到本目录

3. 首次认证

python auth_setup.py

浏览器会弹出，用有「论文推送」标签的 Gmail 账号登录。成功后在同目录生成 token.json。

4. 配置 Claude Code MCP

在 .mcp.json 中添加：

{
  "mcpServers": {
    "gmail-paper": {
      "type": "stdio",
      "command": "python",
      "args": ["<本目录绝对路径>/server.py"],
      "env": {}
    }
  }
}

5. 设置每日定时

Claude Code 中使用 CronCreate 工具：

{
  "cron": "57 8 * * *",
  "prompt": "读取 Gmail「论文推送」标签下过去 24 小时的新邮件并生成日报",
  "recurring": true,
  "durable": true
}

每天上午 8:57 自动拉取论文推送邮件，按来源分组并输出日报。

6. 结合期刊分区

日报中标注每篇论文所属期刊的新锐分区（原中科院分区）和 JCR 影响因子（需配置 cas-journal MCP）。

标签说明

需在 Gmail 中创建名为「论文推送」的标签，将 Google Scholar Alerts 和期刊 TOC 推送自动归类到此标签下。

需要 VPN（国内用户）

国内访问 Google API 需代理。本工具自动检测系统代理设置（urllib.request.getproxies()），确保 VPN 处于开启状态。

文件结构

gmail-paper-digest/
├── server.py          # MCP Server 主程序
├── auth_setup.py      # 首次 OAuth 认证脚本
├── requirements.txt   # Python 依赖
├── .gitignore         # 排除密钥文件
└── README.md

credentials.json 和 token.json 包含密钥，已在 .gitignore 中排除。