Gmail Server for Model Context Protocol (MCP)
2025.02.17
0
Python邮件服务自动化工具交流协作
该MCP服务器与Gmail集成，支持发送、删除、阅读、起草和回复电子邮件。客户端在执行这些操作前会提示用户确认。
View on GitHub
Overview
基本能力
产品定位
该MCP服务器是一个Gmail集成服务，旨在通过MCP协议提供对Gmail邮箱的自动化操作能力。
核心功能
- 发送电子邮件
- 删除电子邮件（移至垃圾箱）
- 标记邮件为已读
- 获取未读邮件列表
- 阅读特定邮件内容
- 在浏览器中打开邮件
适用场景
- 自动化邮件处理工作流
- 邮件管理工具集成
- 邮件通知系统
- 邮件数据分析
工具列表
- send-email
- 功能：向指定收件人发送电子邮件
- 输入参数：
recipient_id：收件人邮箱地址subject：邮件主题message：邮件内容
-
返回：状态和邮件ID
-
trash-email
- 功能：将邮件移至垃圾箱
- 输入参数：
email_id：邮件自动生成的ID
-
返回：成功消息
-
mark-email-as-read
- 功能：标记邮件为已读
- 输入参数：
email_id：邮件自动生成的ID
-
返回：成功消息
-
get-unread-emails
- 功能：获取未读邮件列表
-
返回：包含邮件ID的邮件列表
-
read-email
- 功能：获取指定邮件的内容
- 输入参数：
email_id：邮件自动生成的ID
-
返回：邮件元数据字典，并标记邮件为已读
-
open-email
- 功能：在默认浏览器中打开邮件
- 输入参数：
email_id：邮件自动生成的ID
- 返回：成功消息
常见问题解答
- 如何测试服务器？
- 使用MCP Inspector工具进行测试
- 运行命令示例：
bash npx @modelcontextprotocol/inspector uv run [绝对路径]/src/gmail/server.py --creds-file-path [凭证文件路径] --token-path [令牌文件路径]
使用教程
使用依赖
- 需要安装Google Cloud SDK
- 需要Node.js环境（用于MCP Inspector）
安装教程
- Gmail API设置
- 创建新的Google Cloud项目
- 启用Gmail API
- 配置OAuth同意屏幕（选择"external"）
- 添加OAuth范围
https://www.googleapis.com/auth/gmail/modify - 为"桌面应用"创建OAuth客户端ID
-
下载客户端OAuth密钥的JSON文件
-
认证设置
- 启动服务器时将启动系统浏览器中的认证流程
-
令牌凭证将保存在
--token-path参数指定的路径中 -
与桌面应用集成
- 修改Claude Desktop的服务器配置文件
- 示例配置：
json { "mcpServers": { "gdrive": { "command": "uv", "args": [ "--directory", "[绝对路径]", "run", "gmail", "--creds-file-path", "[凭证文件路径]", "--token-path", "[令牌文件路径]" ] } } }
调试方式
- 使用MCP Inspector进行调试
- 运行命令：
bash npx @modelcontextprotocol/inspector uv run [绝对路径]/src/gmail/server.py --creds-file-path [凭证文件路径] --token-path [令牌文件路径]