MCP 服务器

Gmail Plugin MCP Server

一个 MCP 服务器，它支持 Gmail 集成，允许用户直接通过像 Claude Desktop 这样的 MCP 客户端来管理电子邮件（发送、接收、阅读、删除、标记为已读）。

README

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）

安装

克隆存储库：

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

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

配置

对于开发/未发布的服务器

将此添加到您的 MCP 客户端配置：

"mcpServers": {
  "gmail-plugin": {
    "command": "uv",
    "args": [
      "--directory",
      "[工作目录的绝对路径]",
      "run",
      "server.py"
      "--creds-file-path",
      "[凭据文件的绝对路径]",
      "--token-path",
      "[访问令牌文件的绝对路径]"
    ]
  }
}

对于已发布的服务器

"mcpServers": {
  "gmail-plugin": {
    "command": "uvx",
    "args": [
      "gmail-plugin"
    ]
  }
}

🛠️ 开发

构建和发布

同步依赖项：

uv sync

构建包：

uv build

发布到 PyPI：

uv publish

调试

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uv --directory C:\Users\sanch\Desktop\gmail_plugin\gmail-plugin run gmail-plugin

📚 API 参考

可用工具

工具名称	描述	必需参数
`send-email`	发送电子邮件	recipient_id, subject, message
`get-unread-emails`	检索未读邮件	None
`read-email`	读取电子邮件内容	email_id
`trash-email`	将电子邮件移动到垃圾箱	email_id
`mark-email-as-read`	将电子邮件标记为已读	email_id
`open-email`	在浏览器中打开电子邮件	email_id

可用提示

提示名称	描述	参数
`manage-email`	充当电子邮件管理员	None
`draft-email`	起草一封新电子邮件	content, recipient, recipient_email
`edit-draft`	编辑现有电子邮件草稿	changes, current_draft