关键词

gmailemailai助手邮件管理智能通信

项目简介

systemprompt-mcp-gmail 是一个专门为AI智能体设计的MCP服务器，它充当连接大型语言模型（LLM）客户端与Gmail邮箱的桥梁。通过此服务器，AI智能体可以安全、便捷地访问用户的Gmail数据，并执行邮件相关的操作，如搜索邮件、读取邮件内容、发送邮件以及管理邮件草稿等。该服务器旨在与 multimodal-mcp-client 客户端配合使用，为用户提供语音驱动的邮件管理能力。

主要功能点

  • 邮件搜索: 允许AI智能体根据关键词、发送者、接收者、日期范围等条件搜索Gmail邮箱中的邮件。
  • 邮件读取: 支持AI智能体获取指定邮件的完整内容，包括邮件正文和元数据。
  • 邮件发送: 使AI智能体能够根据用户指令撰写和发送新的邮件或回复邮件。
  • 草稿管理: 提供创建、编辑、列出和删除邮件草稿的功能。
  • AI辅助邮件操作: 利用AI能力辅助邮件的撰写和处理，例如智能生成邮件内容。
  • MCP协议集成: 完全实现了Model Context Protocol，确保与兼容的LLM客户端无缝对接。

安装步骤

  1. 配置 Google API 凭据:

    • 本服务器需要访问Gmail API的权限。您需要设置 'GOOGLE_CREDENTIALS' 和 'GOOGLE_TOKEN' 环境变量。
    • 详细的Google API认证配置步骤，请参考 multimodal-mcp-client 仓库中的 'scripts/google-auth/README.md' 文件，按照指南生成 Base64 编码的 'GOOGLE_CREDENTIALS' 和 'GOOGLE_TOKEN' 字符串。
    • 将生成的 Base64 字符串设置为您的环境变量 'GOOGLE_CREDENTIALS' 和 'GOOGLE_TOKEN'。

  2. 安装 Systemprompt API 密钥:

    • 本服务器需要 Systemprompt API 密钥进行认证。
    • 前往 systemprompt.io/console 获取免费API密钥。
    • 将获取的API密钥设置为环境变量 'SYSTEMPROMPT_API_KEY'。

  3. 运行服务器:

    • 确保您已安装 Node.js 和 npm。
    • 在命令行终端中，导航到您的项目目录。
    • 运行命令 'npx systemprompt-mcp-gmail' 启动服务器。

服务器配置

MCP客户端需要配置以下信息以连接到 systemprompt-mcp-gmail 服务器：

{
  "serverName": "Gmail MCP Server",  // MCP客户端中显示的服务名称，用户可自定义
  "command": "npx",                // 运行服务器的命令，通常为 npx 或 node
  "args": [                         // 运行服务器命令的参数
    "systemprompt-mcp-gmail"      //  服务器启动脚本名称
  ],
  "protocol": "stdio",              //  MCP客户端与服务器通信协议，通常为 stdio
  "description": "Gmail integration via MCP", //  服务的简短描述，用户可自定义
  "enabled": true                  //  是否启用该服务，默认为启用
}

参数注释:

  • 'serverName': 用户在MCP客户端界面看到的服务器名称，可以自定义修改，方便识别。
  • 'command': 运行服务器的命令，这里使用 'npx'，确保可以找到 'systemprompt-mcp-gmail' 包。如果全局安装了 'systemprompt-mcp-gmail'，也可以使用 'node' 并指定服务器入口文件路径。
  • 'args': 传递给 'command' 的参数，'systemprompt-mcp-gmail' 是服务器的启动脚本名称，'npx' 会自动查找并执行该脚本。
  • 'protocol': MCP客户端与服务器之间使用的通信协议，'stdio' 表示标准输入输出流协议，是常用的选择。
  • 'description': 对该服务的简单描述，方便用户理解其功能，可以根据需要修改。
  • 'enabled': 指示此服务是否启用。设置为 'true' 表示启用，MCP客户端会尝试连接此服务器。

基本使用方法

  1. 确保 MCP 客户端（例如 multimodal-mcp-client）已正确安装和配置。
  2. 在 MCP 客户端中配置上述服务器配置信息，以便客户端能够连接到 Gmail MCP Server。
  3. 启动 systemprompt-mcp-gmail 服务器。
  4. 使用 MCP 客户端的界面，通过语音或文本指令，即可开始与您的 Gmail 邮箱进行交互，例如：
    • “搜索最近一周来自 John Doe 的邮件”
    • “阅读主题为 ‘会议邀请’ 的邮件”
    • “回复上一封邮件，内容为 ‘好的，收到！’”
    • “创建一个草稿，收件人为 [email protected]，主题为 ‘工作报告’，内容为 ‘请查阅附件中的报告。’”

请参考 multimodal-mcp-client 客户端的文档，了解如何更详细地使用语音或文本指令与 Gmail MCP Server 进行交互。

信息

分类

通信与社交

访问项目