无头 Gmail MCP 服务器

项目概述

MCP 无头 Gmail 服务器是一个基于 Google API 的服务，用于通过命令行或其他自动化工具与 Gmail 账户交互。它支持读取邮件、获取邮件正文内容以及发送新邮件等功能。

关键优势

1. 完全自动化：无需手动操作，可通过脚本或命令行调用。
2. 高效性能：优化了 API 调用流程，处理大量邮件时效率高。
3. 安全设计：采用令牌认证机制，支持 OAuth 2.0 协议，确保数据传输安全。
4. 扩展性好：易于与其他系统集成，可快速添加更多 Gmail 相关功能。

功能

• 读取邮件：获取收件箱中的邮件列表、邮件内容及详细信息。
• 获取邮件正文：支持分块读取大尺寸邮件的正文内容。
• 发送邮件：通过 API 发送新的邮件，支持 HTML 格式和纯文本格式。

安装

先决条件

1. 注册 Google Cloud 账户并创建项目。
2. 启用 Gmail API。
3. 配置 OAuth 一致性屏幕。
4. 创建 OAuth 客户端 ID（选择桌面应用类型）。
5. 获取访问令牌和刷新令牌，所需作用域包括：
   • https://www.googleapis.com/auth/gmail.readonly（用于读取邮件）
   • https://www.googleapis.com/auth/gmail.send（用于发送邮件）

安装步骤

1. 克隆仓库：

   git clone https://github.com/yourusername/mcp-headless-gmail.git
   cd mcp-headless-gmail
   

2. 安装依赖：

   pip install -r requirements.txt
   

3. 配置环境变量，设置您的 Google API 凭证：

   export GOOGLE_CLIENT_ID=your_client_id
   export GOOGLE_CLIENT_SECRET=your_client_secret
   export GOOGLE_REFRESH_TOKEN=your_refresh_token
   

4. 启动服务：

   python3 server.py
   

Docker 使用

构建镜像

# 基础镜像
FROM python:3.8-slim

# 设置工作目录
WORKDIR /app

# 安装依赖
COPY requirements.txt .
RUN pip install -r requirements.txt

# 复制应用代码
COPY . .

# 环境变量配置
ENV GOOGLE_CLIENT_ID=your_client_id \
    GOOGLE_CLIENT_SECRET=your_client_secret \
    GOOGLE_REFRESH_TOKEN=your_refresh_token

# 启动命令
CMD ["python3", "server.py"]

运行容器

docker build -t mcp-headless-gmail .
docker run -d --name mcp-email-service mcp-headless-gmail

Claude Desktop 配置

1. 添加以下工具到 Claude.yaml：

   tools:
     - name: gmail_get_recent_emails
       path: /api/gmail/recent
     - name: gmail_get_email_body
       path: /api/gmail/body
     - name: gmail_send_email
       path: /api/gmail/send
     - name: gmail_refresh_token
       path: /api/gmail/refresh-token
   

2. 在 Claude 中使用这些工具：

   {
     "tool": "gmail_get_recent_emails",
     "args": {
       "access_token": "${GOOGLE_ACCESS_TOKEN}"
     }
   }
   

跨平台發布

1. 生成多平台镜像：

   docker buildx build --platform linux/amd64,linux/arm64 -t mcp-headless-gmail:multi .
   

2. 推送镜像到 Docker Hub 或其他 registry。

安全注意

• 始终使用 HTTPS 传输数据。
• 不要将凭证提交到公开代码库。
• 定期轮换访问令牌，确保安全。

许可证

詳見 LICENSE 文件。