关键词

Gmail邮件处理LLM应用邮箱集成数据访问

项目简介

Gmail MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为 LLM（大型语言模型）应用提供强大的 Gmail 集成能力。通过此 MCP 服务器，LLM 应用可以安全、便捷地访问和处理 Gmail 邮箱中的数据，实现邮件内容的智能分析、摘要、以及与邮件相关的自动化任务。

主要功能点

  • 邮件读取与搜索: 支持根据关键词、日期范围、邮件状态（如未读、重要）等条件，灵活检索和读取 Gmail 邮件。
  • 邮件内容处理: 能够处理多种邮件内容格式，包括纯文本和 HTML，并支持提取邮件主题、发件人、收件人、正文、附件等关键信息。
  • 邮件格式化输出: 可以将邮件内容格式化为 JSON、CSV 或 TXT 等多种格式，方便 LLM 应用进行后续处理和分析。
  • 资源管理: 将 Gmail 邮箱中的邮件（如最近邮件、未读邮件、重要邮件）作为 MCP 资源进行管理，方便 LLM 客户端按需访问。
  • 工具集成: 提供邮件读取、邮件搜索、邮件格式化等工具，允许 LLM 客户端通过调用工具执行特定邮件操作。

安装步骤

  1. 确保已安装 Node.js 和 npm。
  2. 全局安装 '@cablate/mcp-gmail' 包： 
    npm install -g @cablate/mcp-gmail

服务器配置

要将 Gmail MCP Server 集成到 MCP 客户端（如 Dive Desktop），您需要配置服务器的启动命令和相关参数。以下是配置示例，请根据您的实际情况进行调整：

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@cablate/mcp-gmail"],
      "env": {
        "GMAIL_CLIENT_ID": "your_client_id",        // 您的 Gmail API 客户端 ID，请替换为实际值
        "GMAIL_CLIENT_SECRET": "your_client_secret",  // 您的 Gmail API 客户端密钥，请替换为实际值
        "GMAIL_REFRESH_TOKEN": "your_refresh_token"   // 您的 Gmail API 刷新令牌，请替换为实际值
      },
      "enabled": true
    }
  }
}

注意:

  • 您需要先完成 Gmail API 的身份验证设置，并获取 'GMAIL_CLIENT_ID', 'GMAIL_CLIENT_SECRET', 和 'GMAIL_REFRESH_TOKEN'。请参考仓库中的 'guide.md' 文件获取详细的 Gmail API 设置指南。
  • 在 MCP 客户端中添加 MCP Server 时，复制粘贴以上 JSON 配置，并确保替换为您自己的 Gmail API 凭据。

基本使用方法

  1. 启动 MCP 客户端，并按照上述“服务器配置”步骤添加 Gmail MCP Server。
  2. 在 MCP 客户端中，您可以：
    • 列出可用的 MCP 资源，例如 "gmail://recent"（最近邮件）, "gmail://unread"（未读邮件）, "gmail://important"（重要邮件）。
    • 调用预置的工具，例如 "email_reader"（读取邮件）, "email_search"（搜索邮件）, "email_formatter"（格式化邮件），并根据工具的输入参数执行相应的邮件操作。
    • 通过 MCP 客户端与 Gmail MCP Server 交互，获取邮件数据或执行邮件相关的功能。

具体的使用方式和工具调用方法，请参考您的 MCP 客户端的使用文档和 Gmail MCP Server 提供的工具及资源信息。

信息

分类

通信与社交

访问项目