Gmail 插件 MCP 服务器

一个强大的 MCP 服务器，支持 Gmail 集成，允许您通过 MCP 客户端直接管理电子邮件。此插件提供对 Gmail 核心功能的无缝访问，包括阅读、发送和管理电子邮件。

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

🎥 演示

https://github.com/user-attachments/assets/df9e86cf-1f6b-4265-9c68-b3ed88103d1f

✨ 功能

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

🚀 快速开始

先决条件

• 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)

🛠️ 开发

构建和发布

1. 在项目根目录中运行：

   uv run build
   

2. 在构建目录中找到生成的文件。

调试

在 app.py 中添加以下调试日志：

from logging.config import dictConfig

# 配置日志
dictConfig({
    'version': 1,
    'disable_existing_loggers': False,
    'formatters': {
        'default': {
            'format': '[%(asctime)s] %(levelname)s in %(module)s: %(message)s',
        },
    },
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
            'formatter': 'default',
            'level': 'DEBUG',
        },
    },
    'root': {
        'level': 'INFO',
        'handlers': ['console'],
    },
})

📋 API 参考

工具

示例

在 app.py 中：

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

🤝 贡献

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

📄 许可证

本项目受 MIT License 保护。