🚀 Gmail 插件 MCP 服务器

这是一个强大的 MCP 服务器，支持与 Gmail 集成。借助它，你能通过 MCP 客户端直接管理电子邮件，无缝访问 Gmail 的核心功能，如阅读、发送和管理邮件等。

💡 参考：查看 这个示例 了解使用 uvx 的 MCP 服务器实现示例。

🚀 快速开始

先决条件

• Python 3.12 或更高版本
• Gmail API 凭证
• MCP 客户端（如 Claude Desktop）

安装

1. 克隆仓库：

git clone https://github.com/yourusername/gmail-plugin.git
cd gmail-plugin

2. 安装依赖项（选择一种方法）：

# 方法 1: 在编辑模式下安装
uv pip install -e .

# 方法 2: 使用 requirements.txt 安装
uv pip install -r requirements.txt

# 方法 3: 推荐使用 uv sync
uv sync --dev --all-extras

3. 配置 Gmail API 凭证：
   • 访问 Google Cloud Console
   • 创建新项目或选择现有项目
   • 启用 Gmail API
   • 配置 OAuth 一致性屏幕：
     • 选择“外部”用户类型（无需发布）
     • 转到受众群体标签：添加您的电子邮件作为“测试用户”
     • 添加 OAuth 作用域：https://www.googleapis.com/auth/gmail/modify
   • 创建 OAuth 2.0 凭证：
     • 选择“桌面应用”作为应用程序类型
     • 下载 JSON 凭证文件
   • 保存凭证文件并记下其绝对路径（将用于 --creds-file-path）

配置

开发/未发布的服务器

在您的 MCP 客户端配置中添加以下内容：

# 方法 1: 在编辑模式下安装
uv pip install -e .

# 方法 2: 使用 requirements.txt 安装
uv pip install -r requirements.txt

# 方法 3: 推荐使用 uv sync
uv sync --dev --all-extras

发布的服务器

在 app.py 中添加以下内容：

if __name__ == "__main__":
    app.run(debug=True)

✨ 主要特性

• 📧 发送和接收电子邮件
• 📥 阅读未读消息
• 🗑️ 删除电子邮件
• 📱 在浏览器中打开电子邮件
• 📝 标记电子邮件为已读
• 🔒 使用 OAuth2 进行身份验证

🎥 演示

演示链接

📦 安装指南

克隆仓库

git clone https://github.com/yourusername/gmail-plugin.git
cd gmail-plugin

安装依赖

# 方法 1: 在编辑模式下安装
uv pip install -e .

# 方法 2: 使用 requirements.txt 安装
uv pip install -r requirements.txt

# 方法 3: 推荐使用 uv sync
uv sync --dev --all-extras

配置凭证

• 访问 Google Cloud Console
• 创建新项目或选择现有项目
• 启用 Gmail API
• 配置 OAuth 一致性屏幕：
  • 选择“外部”用户类型（无需发布）
  • 转到受众群体标签：添加您的电子邮件作为“测试用户”
  • 添加 OAuth 作用域：https://www.googleapis.com/auth/gmail/modify
• 创建 OAuth 2.0 凭证：
  • 选择“桌面应用”作为应用程序类型
  • 下载 JSON 凭证文件
• 保存凭证文件并记下其绝对路径（将用于 --creds-file-path）

💻 使用示例

基础用法

在 app.py 中：

@app.route('/')
def home():
    return "欢迎使用 Gmail 插件 MCP 服务器！"

📚 详细文档

API 参考

工具

🤝 贡献

1. fork 项目仓库。
2. 创建功能分支：git checkout -b feature/your-feature
3. 提交更改：git commit -m '添加新功能'
4. 推送到 fork：git push origin feature/your-feature
5. 创建拉取请求。

📄 许可证

本项目受 MIT License 保护。