🚀 Gmail MCP 服务器

一个强大且灵活的 Gmail 集成服务器，基于消息控制协议 (MCP) 框架构建。它提供了与 Gmail API 交互的强大界面，支持程序化地读取、发送和管理电子邮件，为用户提供高效的邮件处理体验。

🚀 快速开始

Gmail MCP 服务器是一款强大的工具，能帮助你高效地与 Gmail API 进行交互。在使用前，请确保完成以下步骤：

1. 检查并满足先决条件。
2. 完成服务器的安装与配置。
3. 启动服务器并访问应用。

✨ 主要特性

• 可从多个 Gmail 账户读取邮件，满足多账户管理需求。
• 支持发送带附件的邮件，方便信息传递。
• 具备高级查询选项，可精准搜索邮件。
• 能够下载邮件附件，便于获取相关资料。
• 可处理邮件对话和线程，让邮件管理更有序。
• 支持实时监控邮件，及时掌握邮件动态。
• 支持多个 Gmail 账户同时使用。

📦 安装指南

使用 Smithery 安装

通过 Smithery 可自动安装 Gmail 集成服务器，命令如下：

npx -y @smithery/cli install @Quantum-369/Gmail-mcp-server --client claude

手动安装

1. 克隆仓库：

git clone <your-repository-url>
cd gmail-mcp-server

2. 创建并激活虚拟环境：

python -m venv venv
# 在 Windows 上
venv\Scripts\activate
# 在 Unix/MacOS 上
source venv/bin/activate

3. 安装依赖项：

pip install .

📚 详细文档

先决条件

在运行 Gmail MCP 服务器之前，请确保具备以下条件：

1. Python 3.12 或更高版本。
2. 启用了 Gmail API 的 Google Cloud 项目。
3. OAuth 2.0 客户端 ID 凭证。
4. 所需的 Python 包（指定在 pyproject.toml 中）。

设置 Google Cloud 项目

1. 访问 Google Cloud Console。
2. 创建新项目或选择现有项目。
3. 启用项目的 Gmail API。
4. 创建 OAuth 2.0 凭证：
   • 转到 "APIs & Services" > "Credentials"。
   • 点击 "Create Credentials" > "OAuth client ID"。
   • 选择 "Desktop app" 作为应用类型。
   • 下载客户端配置文件。
5. 将下载的文件重命名为 client_secret.json 并放在项目根目录中。

配置

1. 在 gmail_token_creator.py 中设置电子邮件标识符：

email_identifier = 'your.email@gmail.com'  # 根据每个账户修改此值

2. 运行令牌创建工具以身份验证您的 Gmail 账户：

python gmail_token_creator.py

3. 对于要集成的每个 Gmail 账户，重复上述步骤。

服务器结构

• gmail_server.py：核心服务器文件。
• settings.py：配置和设置。
• templates/：HTML 模板目录。
• static/：静态资源目录。

使用方法

安装依赖项

使用 pip 安装所需的 Python 包：

pip install -r requirements.txt

启动服务器

运行以下命令启动 Gmail MCP 服务器：

python gmail_server.py

访问应用

打开浏览器访问 http://localhost:8000。

安全注意事项

⚠️ 重要提示

• 将所有敏感文件（如 client_secret.json）加密并存储在安全位置。
• 避免将凭证提交到版本控制系统中，可以将其加入 .gitignore 文件。
• 使用环境变量来管理敏感信息，而不是硬编码在代码中。

错误处理

日志记录

服务器使用日志文件记录操作状态和错误信息。默认情况下，日志文件位于 logs/ 目录中。

调试

检查 settings.py 中的日志级别设置，以调整输出的详细程度。

贡献指南

克隆仓库

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

提交更改

1. 创建功能分支：

git checkout -b feature/new-feature

2. 提交更改：

git add .
git commit -m "添加新功能"

3. 推送到原点并创建拉取请求：

git push origin feature/new-feature

📄 许可证

此项目受 MIT License 保护。

📞 联系方式

有问题或建议？请发送邮件到 contact@example.com 或在 GitHub 上提交问题。