Gmail邮件服务管理器
项目介绍
Gmail MCP Bridge
English | 中文文档 README.zh-CN.md
通过Claude控制Gmail。无需Google Cloud。无需OAuth。无需API密钥。
通过Chrome扩展程序和模型上下文协议（Model Context Protocol）实现AI助手对Gmail的自动化操作。本地运行，尊重浏览器会话，无需Google API密钥。
如果这个项目对你有帮助，请⭐给仓库点赞，并加入讨论。
⚡ 强大优势：无需Google Cloud项目。无需OAuth同意屏幕。无需API密钥。它使用你现有的Chrome会话在Gmail中执行操作。
为什么不需要Google Cloud
该项目通过利用你现有的Chrome浏览器会话来本地运行。扩展程序和MCP服务器以与你在浏览器中的方式相同的方式在Gmail上执行操作，因此你不需要设置Google Cloud项目、OAuth同意屏幕或任何API密钥。
优点：
- 简化入门：无需云控制台，无需OAuth应用审核。
- 隐私：操作仅限于你的本地浏览器会话。
- 可移植性：在任何可以运行Chrome的地方都能工作。
需要注意的限制：
- 需要安装并登录到目标Gmail账户的Chrome。
- 操作遵循你当前Gmail会话的权限。
⚡ 安装
对于引导式设置，请参阅快速开始和网站：
前提条件：
- Node.js 18+
- Google Chrome（最新版本）
- Claude Desktop（启用MCP）
# 推荐的一键安装
./bin/gmail-mcp install
# 或手动设置
cd gmail-mcp-extension/mcp-server && npm install
📁 项目结构
gmail-mcp/
├── bin/ # 命令行工具（安装器/管理器）
│ └── gmail-mcp
├── gmail-mcp-extension/ # Chrome扩展程序 + MCP桥接服务器
│ ├── extension/ # Chrome扩展源代码
│ ├── mcp-server/ # MCP桥接服务器
│ └── src/ # 核心逻辑和恢复系统
├── docs/ # 文档
│ ├── planning/
│ ├── reports/
│ └── analysis/
├── scripts/ # 工具脚本
│ ├── test/
│ └── util/
├── src/ # 高级功能
│ ├── core/
│ └── plugins/
├── tests/
├── tools/
└── 关键文档
├── README.md
├── README.zh-CN.md
├── CLAUDE.md
├── CONTRIBUTING.md
└── RELEASE.md
🚀 功能
- 阅读/搜索/发送/回复邮件
- 支持完整的Gmail搜索语法
- 多账户切换
- 自动恢复（常见故障恢复率95%以上）
- 自诊断和修复工具
- 低延迟、高吞吐量本地桥接
🎯 使用
命令行管理
gmail-mcp status # 检查系统状态
gmail-mcp doctor # 诊断问题
gmail-mcp fix # 自动修复常见问题
gmail-mcp test # 运行测试
在Claude Desktop中
安装后，只需询问Claude：
- “查看我最新的邮件”
- “给john@example.com发送一封邮件”
- “搜索包含‘项目’的邮件”
📚 文档
- 开发者架构：docs/developer/architecture.md
- 发展路线图：docs/planning/COMPREHENSIVE_IMPROVEMENT_ROADMAP.md
- 贡献指南：CONTRIBUTING.md
🎬 演示 / 截图
以下是占位截图；不久将添加一个简短的演示GIF。
计划：docs/assets/screenshots/demo.gif（≤10秒）。
如果你愿意帮忙，请查看“好的初次问题”。
🏆 为什么选择这个项目
- 无需API密钥，直接与你的浏览器会话交互
- 快速本地桥接，适用于AI助手
- 具备安装器和诊断工具的生产就绪结构
🔗 社交预览（Open Graph）
通过上传社交图片来改善分享仓库时的链接预览：
- 使用
docs/assets/images/og-preview.svg中的占位符（如有需要，导出为1200×630 PNG） - 前往GitHub → 仓库设置 → 通用 → 社交预览 → 上传图片
🤝 贡献
欢迎PR！请阅读CONTRIBUTING.md。
📄 许可证
MIT许可证 — 详情见LICENSE
Gmail MCP Bridge — 通过MCP从Claude Desktop控制Gmail 🚀