Gmail MCP Server 15s

🚀 Gmail MCP 服务器

Gmail MCP 服务器是一个集成了 FastMCP（模型控制协议）的 Gmail 系统，它为 AI 助手搭建了桥梁，使其能借助一系列工具和提示与 Gmail 进行交互，极大地拓展了 Gmail 的使用场景和便捷性。

🚀 快速开始

此项目采用服务器 - 客户端架构，让 AI 助手能够执行多种 Gmail 操作，如发送邮件、查看未读邮件等。使用 OAuth 2.0 进行身份验证，并结合 Gmail API 实现这些功能。

启动服务器

python3 gmail_server.py

使用客户端

from gmail_client import GmailClient
client = GmailClient()
result = client.send_email(to="recipient@example.com", subject="Test", message="Hello World!")
print(result)

✨ 主要特性

• 集成 FastMCP 协议，为 AI 助手与 Gmail 交互提供支持。
• 支持多种 Gmail 操作，包括发送邮件、查看未读邮件等。
• 使用 OAuth 2.0 进行身份验证，保障系统安全。
• 集成 LLM（如 Gemini 1.5 Flash），能理解自然语言请求并执行相应操作。

📦 安装指南

先决条件

• 需要 Python 3.6 或更高版本。
• 安装必要的库：google-auth、google-api-python-client、fastmcp。

准备文件

• credentials.json：OAuth 凭证文件，由 Google 开发者控制台生成。
• token.json：存储 OAuth 认证后的令牌。
• .env：包含 API 密钥和相关配置。

💻 使用示例

基础用法

from gmail_client import GmailClient
client = GmailClient()
result = client.send_email(to="recipient@example.com", subject="Test", message="Hello World!")
print(result)

🔧 技术细节

邮件内容处理

支持 MIME 消息解析、多部分邮件和附件处理，确保正确解码邮件头和正文。

LLM 集成

使用 Gemini 1.5 Flash 将自然语言请求转换为结构化的工具调用，并通过回退机制处理不规范的响应。

📚 详细文档

组件

Gmail Server

负责 FastMCP 集成、身份验证、邮件操作（发送、接收等）以及错误处理和日志记录。

Smart Gmail Client

使用 LLM（如 Gemini 1.5 Flash）来理解自然语言请求，提取参数并执行相应的邮件操作。

开发扩展

添加新的 Gmail 操作

1. 在 gmail_server.py 中实现新工具。
2. 系统将自动发现并暴露新功能。

自定义 LLM 提示

可以通过修改 test_gmail_server.py 中的提示词，优化参数提取和特定请求处理。

⚠️ 安全注意事项

项目不包含凭证文件，请勿提交以下文件到版本控制系统：

• credentials.json
• token.json
• .env

这些文件已添加到 .gitignore 中以防止意外提交。

📄 参考资料

Medium 文章