AI导哈

Gmail MCP服务器

高性能模型上下文协议（MCP）服务器，使AI助手能够安全地与Gmail交互。

  • by uncommontayo
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Uncommontayo/MLI-MCP-Server

使用说明

Gmail MCP服务器📧

一个高性能的模型上下文协议（MCP）服务器，使AI助手能够安全地与Gmail交互。

✨ 特性

  • 智能电子邮件检索：获取具有丰富元数据的未读邮件。
  • 线程感知绘图：创建保持对话上下文的回复。
  • 安全认证：具有令牌管理的强大OAuth 2.0实现。
  • 企业级就绪：结构可扩展性和可维护性。

🏗️ 建筑

系统数据流

graph TD
    User(["👤 User"]) <-->|"Natural Language"| Claude(["🤖 Claude Desktop"])
    
    subgraph "MCP Server (Local Machine)"
        Claude <-->|"JSON-RPC (stdio)"| Main["src/main.py"]
        Main -->|Dispatch| Handler["src/handlers.py"]
        Handler -->|Call| Client["src/client.py"]
    end
    
    Client <-->|"HTTPS / OAuth 2.0"| Gmail(["☁️ Google Gmail API"])
    
    style User fill:#f9f,stroke:#333
    style Claude fill:#e1f5fe,stroke:#01579b
    style Gmail fill:#fce4ec,stroke:#880e4f

该项目遵循标准工程实践：

MLI/
├── src/
│   ├── main.py          # Application Entry Point
│   ├── client.py        # Gmail API Client
│   └── handlers.py      # Request Handlers
├── config/              # Configuration & Credentials
├── tests/               # Unit Tests
└── requirements.txt     # Dependencies

🚀 快速开始

1.先决条件

  • Python 3.8+
  • 启用Gmail API的谷歌云项目

2.安装

# Clone and setup environment
python -m venv .venv
.venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

3.配置

  1. 放置您的谷歌云 credentials.json 在 config/.
  2. 复制环境配置：
    copy .env.example .env

4.克劳德整合

添加到您的 克劳德桌面版 config(%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "gmail": {
      "command": "C:\\Path\\To\\MLI\\.venv\\Scripts\\python.exe",
      "args": ["-m", "src.main"],
      "cwd": "C:\\Path\\To\\MLI",
      "env": {
        "CREDENTIALS_PATH": "config/credentials.json",
        "TOKEN_PATH": "config/token.json"
      }
    }
  }
}

🛠️ 用法

检查电子邮件：

“检查我的未读电子邮件”

答复草案：

“起草对[姓名]电子邮件的回复”

🛡️ 安全

  • 凭据从不提交到版本控制。
  • 令牌存储在本地 config/.
  • 您的机器和Google API之间直接进行通信。

相关 MCP