JinDaGe - imap-mcp-server MCP Details

article

README

🚀 Gmail MCP 服务器

这是一个基于 IMAP 协议的 Gmail 管理服务器，集成了 AI 分析和批量处理功能，能助力您高效管理 Gmail 账户。

🚀 快速开始

Gmail MCP 服务器可通过集成 AI 分析和批量处理功能，帮助您高效管理 Gmail 账户。

✨ 主要特性

AI 邮箱分析：借助机器学习算法，为您提供邮箱使用洞察。
智能文件夹创建：自动依据规则对邮件进行分类。
批量操作支持：涵盖移动、删除、标记等多种操作。
邮件归档到 GCS：支持将邮件及其附件迁移至 Google Cloud Storage。

📦 安装指南

准备 Gmail 凭据
- 需具备 IMAP 访问权限和 OAuth 2.0 支持。
配置服务器设置
- 配置 Gmail 账户信息、端点地址等参数。
启动服务
- 启动 MCP 服务器并连接到 Gmail 服务。

💻 使用示例

基础用法

# 分析最近一周的邮箱数据
inbox_analysis = analyze_inbox(days=7)

# 批量标记重要邮件
batch_process(folder='INBOX', action='label', criteria='unread AND importance:high')

# 将重要邮件迁移到 GCS
migrate_email_to_gcs(uid='123456', folder='INBOX', gcs_prefix='important-mails')

📚 详细文档

功能模块

邮箱分析

analyze_inbox(days=7)：分析过去指定天数的邮箱数据，返回活动报告。
get_folder_summary(folder)：获取指定文件夹的统计信息，包括邮件数量和活跃度趋势。

批量操作

batch_process(folder, action, filter_criteria)：对指定文件夹中的邮件执行批量操作，支持动作包括移动、删除、标记等。

智能分类

create_smart_folder(name, rules)：创建自定义智能文件夹，根据指定规则自动分类邮件。

邮件迁移

migrate_email_to_gcs(uid, folder, gcs_prefix)：将指定邮件及其附件迁移到 Google Cloud Storage。

🔧 技术细节

依赖环境

| 属性 | 详情 | |------|------| | 模型类型 | 无 | | 训练数据 | 无 | | Python 版本 | 3.8+ | | IMAP 库 | imaplib | | GCS 接口 | google - cloud - storage |

认证要求

OAuth 2.0 支持
IMAP 全局读取权限

📄 许可证

文档未提及相关信息，跳过该章节。

使用场景

企业邮件管理：可对大量员工邮箱进行统一管理和分析。
数据迁移：能将历史邮件和附件迁移到云端存储。
自动化处理：通过批量操作实现邮件自动分类和清理。

⚠️ 重要提示

请遵守 Gmail 的 API 使用规范和速率限制，确保拥有合法的授权权限，并定期更新凭据信息。如需更多详细信息，请参考完整的开发者文档。

imap-mcp-server