Gmail AutoAuth MCP Server 使用说明

项目简介

Gmail AutoAuth MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，专门为 Claude Desktop 等 MCP 客户端设计，旨在通过自然语言交互方式，安全便捷地控制和管理用户的 Gmail 邮箱。它充当 AI 助手与 Gmail API 之间的桥梁，让 AI 能够执行发送邮件、读取邮件、搜索邮件、管理标签等操作。

主要功能点

邮件发送: 支持发送带有主题、正文、附件以及指定收件人、抄送人和密送人的邮件。
邮件草稿: 支持创建邮件草稿，暂不发送邮件。
邮件读取: 可以根据邮件 ID 读取邮件内容，并处理复杂的 MIME 结构，提取纯文本和 HTML 内容。
邮件搜索: 支持使用 Gmail 强大的搜索语法来查找邮件。
邮件管理: 支持修改邮件标签（例如移动到文件夹、存档）、标记邮件为已读/未读、以及删除邮件。
标签管理: 可以列出 Gmail 中所有可用的标签。
附件处理: 能够查看邮件附件信息（文件名、类型、大小）。
国际字符支持: 完全支持包括中文在内的各种国际字符，确保邮件内容正确显示。
OAuth 2.0 自动认证: 采用简单的 OAuth2 认证流程，自动打开浏览器完成认证，并安全存储凭据。

安装步骤

创建 Google Cloud 项目并获取凭据：
- 访问 Google Cloud Console，创建一个新的 Google Cloud 项目或选择现有项目。
- 在项目中启用 Gmail API。
- 创建 OAuth 2.0 客户端 ID，选择“桌面应用”或“Web 应用程序”作为应用类型。
- 如果选择“Web 应用程序”，请将 'http://localhost:3000/oauth2callback' 添加到授权重定向 URI。
- 下载客户端 OAuth 密钥的 JSON 文件，并重命名为 'gcp-oauth.keys.json'。

安装 Gmail AutoAuth MCP Server：

方法一：通过 Smithery (推荐 Claude Desktop 用户使用)

npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude

方法二：手动安装

npm install -g @gongrzhe/server-gmail-autoauth-mcp

认证： 将 'gcp-oauth.keys.json' 文件放置在当前工作目录或用户家目录下的 '.gmail-mcp' 文件夹中（例如 '~/.gmail-mcp/'）。运行以下命令进行认证：
```
npx @gongrzhe/server-gmail-autoauth-mcp auth
```
或 (如果全局安装)
```
gmail-mcp-server auth
```
该命令将自动打开浏览器进行 Google 账户认证。认证成功后，凭据将保存在 '~/.gmail-mcp/credentials.json' 文件中。

服务器配置 (Claude Desktop)

要将 Gmail AutoAuth MCP Server 集成到 Claude Desktop，请将以下 JSON 配置添加到 Claude Desktop 的配置文件 'claude_desktop_config.json' 中（通常位于用户配置目录下，例如 Windows 的 '%APPDATA%\Claude'，macOS 的 '~/Library/Application Support/Claude'，Linux 的 '~/.config/Claude'）：

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

配置参数说明：

'"gmail"': 服务器名称，在 Claude Desktop 中用于标识 Gmail MCP 服务器。
'"command": "npx"': 运行服务器的命令，这里使用 'npx' 来运行本地安装的 npm 包。
'"args": ["@gongrzhe/server-gmail-autoauth-mcp"]': 'npx' 命令的参数，指定要运行的 npm 包名称，即 Gmail AutoAuth MCP Server 的入口。

基本使用方法

确保 Gmail AutoAuth MCP Server 已成功安装和认证。
将上述服务器配置添加到 Claude Desktop 的配置文件中。
启动 Claude Desktop 客户端。
在 Claude Desktop 中，你可以通过自然语言指令指示 AI 助手使用 Gmail 功能。例如，你可以对 Claude 说：
- "发送邮件给 [email protected]，主题是会议纪要，内容是：请查收会议纪要。"
- "搜索来自 [email protected] 的邮件。"
- "读取邮件 ID 为 12345 的邮件。"

Claude Desktop 将会调用 Gmail AutoAuth MCP Server 提供的工具来执行相应的 Gmail 操作。

关键词