项目简介

Trusted Gmail MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务器，专注于为LLM客户端提供安全可信的Gmail邮件上下文访问能力。该服务器运行在 AWS Nitro Enclave 安全环境中，利用硬件隔离技术增强安全性，并通过 SSE (Server-Sent Events) 协议与客户端通信。它旨在桥接LLM应用和用户的Gmail邮箱，实现邮件资源的智能化管理和利用。

主要功能点

邮件检索: 支持在指定日期范围内或根据关键词搜索Gmail邮箱中的邮件，方便LLM获取相关邮件信息。
邮件内容获取: 允许LLM根据邮件ID获取邮件的完整内容，包括发件人、收件人、日期、主题和正文。
邮件统计: 能够统计指定日期范围内每天收到的邮件数量，帮助LLM分析邮件趋势。
邮件发送: 提供邮件发送工具，经过用户确认后，LLM可以调用该工具发送邮件。
安全性: 运行于AWS Nitro Enclave，利用硬件隔离和代码验证机制，增强服务器的安全性，保护用户Gmail凭据。
远程访问: 通过 SSE 协议提供远程访问能力，客户端可以通过URL连接到服务器，无需本地部署。

安装步骤

环境准备: 确保已配置 AWS EC2 环境，并选择支持 Nitro Enclave 的实例类型。

克隆仓库: 在 EC2 实例中克隆 GitHub 仓库 'trusted-mcp-server'。

git clone https://github.com/0xfreysa/trusted-mcp-server
cd trusted-mcp-server

运行安装脚本: 执行 'setup.sh' 脚本下载必要的依赖。
```
sudo ./setup.sh
```
配置 Enclave 内存 (可选): 如果需要，可以修改 '/etc/nitro_enclaves/allocator.yaml' 文件增加 Enclave 可用内存，并重启 'nitro-enclaves-allocator.service' 服务。
构建和运行 Enclave: 使用 'make' 命令构建 Enclave 镜像，并使用 'make run' 在生产模式下运行服务器。
```
make
make run
```
启动 GVProxy: 运行 'gvproxy.sh' 脚本，以便外部客户端可以访问 Enclave 内的服务。
```
./gvproxy.sh
```

服务器配置

MCP 客户端需要配置服务器连接信息，以下是一个 'mcp.json' 示例配置块，您需要将其添加到您的客户端配置文件中。

    "gmail_mcp": {
      "url": "https://gmail.mcp.freysa.ai/sse/?ADDR=<[email protected]>&ASP=<your app-specific password>"
    }

配置参数说明:

url: MCP 服务器的 SSE 连接 URL。
- ADDR: 您的 Gmail 邮箱地址，请替换 '[email protected]' 为您的实际邮箱地址。
- ASP: 您的 Gmail 应用专用密码 (App-Specific Password)，请替换 '<your app-specific password>' 为您生成的应用专用密码。请注意，通过URL传递应用专用密码存在安全风险，请仔细阅读仓库的安全提示，并考虑使用更安全的连接方式（如VPN或私有网络）。

请务必重启您的 MCP 客户端以使配置生效。

基本使用方法

配置完成后，您的 MCP 客户端应该能够通过 "gmail_mcp" 这个服务器名称连接到 Trusted Gmail MCP Server。您可以使用客户端提供的界面或命令来调用服务器提供的工具，例如：

使用 'search_emails' 工具搜索邮件，可以指定 'start_date'、'end_date' 和 'keyword' 参数进行更精确的搜索。
使用 'get_email_content' 工具获取指定 'email_id' 的邮件内容。
使用 'count_daily_emails' 工具统计每日邮件数量，需要提供 'start_date' 和 'end_date' 参数。
使用 'send_email' 工具发送邮件，需要提供 'to' (收件人列表)、'subject' (邮件主题) 和 'content' (邮件正文) 参数。

请注意: 首次使用可能需要生成 Gmail 应用专用密码，并仔细阅读仓库提供的安全注意事项。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息