项目简介

该项目实现了一个基于 Model Context Protocol (MCP) 的服务器端应用，旨在将用户的 Gmail 邮箱和 Google Calendar 功能集成到支持 MCP 协议的 LLM 客户端（例如 Claude Desktop）中。通过这个服务器，LLM 客户端可以以标准化的方式调用 Gmail 和 Google Calendar 的 API，执行如发送邮件、获取邮件摘要、创建日历事件等任务。

主要功能点

• 邮件摘要： 获取最近邮件的摘要，帮助快速了解收件箱内容。
• 发送邮件： 通过自然语言指令，直接从 LLM 客户端发送新邮件，支持收件人、主题、正文、抄送和密送。
• 日历事件创建： 手动创建 Google Calendar 事件，或配置自动从标记为“重要”的邮件中提取信息创建日历事件。
• 自动化处理： 可设置定期（如每10分钟）扫描邮箱，自动为符合条件的邮件创建日历事件。

安装步骤

1. 确保您已安装 Python 3.8 或更高版本。
2. 确保您已安装并配置支持 MCP 协议的 LLM 客户端（例如 Claude Desktop）。
3. 前往 Google Cloud Platform 控制台，创建一个新项目，并启用 Gmail API 和 Google Calendar API。
4. 为您的 Google Cloud 项目设置 OAuth 2.0 凭据，下载 'credentials.json' 文件。
5. 将下载的 'credentials.json' 文件放置在特定目录下：
   • 在 Linux/macOS 系统上，通常是 '~/.gmail_mcp_server/credentials.json'。
   • 在 Windows 系统上，通常是 '%USERPROFILE%.gmail_mcp_server\credentials.json' (即用户主目录下的 '.gmail_mcp_server' 文件夹)。
6. 通过 pip 安装服务器软件包：

   pip install gmail-mcp-server
   

服务器配置

本服务器是一个 MCP 后端，需要由 MCP 客户端进行配置和启动。典型的 MCP 客户端配置会要求提供服务器的相关信息，以便客户端能够启动并与之通信。

• 服务器名称 (Server Name): 该服务器在 MCP 协议中标识自己的名称是 '"EmailMcpServer"'。您的客户端配置可能需要指定此名称。
• 启动命令 (Command) 及参数 (Args): 客户端需要知道执行哪个命令来启动这个服务器进程。安装后，这通常是一个 Python 命令，例如可能是 'python -m gmail_mcp_server.server' 或软件包定义的其他入口点命令。启动命令通常不需要额外的命令行参数。
• 具体如何在您的 MCP 客户端中配置外部服务器，请查阅您使用的客户端的官方文档。

基本使用方法

一旦 MCP 服务器通过您的 LLM 客户端成功启动并连接，LLM 就可以通过调用服务器提供的工具来执行相应的任务。例如，LLM 可以根据您的指令调用 'summarize_emails' 工具来获取邮件摘要，或调用 'send_email' 工具来发送邮件。您可以通过自然语言向 LLM 客户端发出请求，让它利用这个服务器的能力来管理您的邮件和日历。