G

Gmail内容处理器服务器

@cskiro/gmail-mcp-server
0 Stars 43 次浏览 cskiro 更新于 2026-08-23

允许 Claude Desktop 安全访问和处理 Gmail 内容的同时保持正确上下文管理和隐私控制的集成服务器。

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

Gmail MCP 服务器

一个模型上下文协议（MCP）服务器，将Gmail与Claude桌面版集成，使Claude能够访问和理解电子邮件内容，同时保持适当的上下文管理和隐私控制。

功能

  • 通过OAuth2认证的Gmail API集成
  • 安全的令牌管理和存储
  • 以隐私为重点的数据处理
  • 为Claude管理上下文窗口
  • 全面的日志记录和错误处理
  • 支持Docker以便于部署

前提条件

  • Node.js >= 18.0.0
  • npm 或 yarn
  • 已启用Gmail API的Google云项目
  • Claude API密钥

设置

  1. 克隆仓库：
git clone https://github.com/yourusername/gmail-mcp-server.git
cd gmail-mcp-server
  1. 安装依赖项：
npm install
  1. 在根目录下创建一个.env文件，并包含以下变量：
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=http://localhost:3000/auth/google/callback
CLAUDE_API_KEY=your_claude_api_key
PORT=3000
  1. 启动开发服务器：
npm run dev

开发

  • npm run dev: 使用热重载启动开发服务器
  • npm test: 运行测试
  • npm run lint: 运行ESLint

项目结构

gmail-mcp-server/
├── src/
│   ├── server.js          # Main server entry point
│   ├── auth.js            # Authentication handling
│   ├── gmail.js           # Gmail API integration
│   ├── claude.js          # Claude API integration
│   ├── logger.js          # Logging configuration
│   └── utils/             # Utility functions
├── tests/                 # Test files
├── .env                   # Environment variables
├── .gitignore            # Git ignore rules
├── package.json          # Project dependencies
└── README.md             # Project documentation

贡献

  1. 叉分仓库
  2. 创建你的特性分支 (git checkout -b feature/amazing-feature)
  3. 提交你的更改 (git commit -m 'Add some amazing feature')
  4. 推送到该分支 (git push origin feature/amazing-feature)
  5. 打开一个Pull Request

许可证

本项目根据MIT许可证发布 - 详情请参见LICENSE文件。

查看源码 项目主页