项目简介

Programmable Email 是一个 MCP (Model Context Protocol) 服务器，旨在连接 Claude 或任何 MCP ��户端与 Gmail 邮箱。通过此服务器，LLM 客户端（如 Claude）可以安全地访问和操作用户的 Gmail 邮箱数据，例如读取邮件。请注意，此项目目前为实验性阶段，读取的邮件内容会发送到 Claude 的服务器。

主要功能点

• 读取Gmail邮件：允许 MCP 客户端通过工具调用，检索用户的 Gmail 邮箱中的邮件，支持按数量、未读状态、邮件主题等条件进行筛选。

安装步骤

1. 准备 Gmail OAuth 凭据

   • 访问 Google Cloud Console 创建 OAuth 客户端 ID 凭据，应用类型选择桌面应用。
   • 下载 'credentials.json' 文件，并将其放置在项目根目录下。
   • 首次运行服务器时，会自动生成 'token.json' 文件用于存储授权令牌。

2. 安装 Docker

   • 确保您的系统已安装 Docker。如果未安装，请根据您的操作系统查阅 Docker 官方文档进行安装。

3. 构建 Docker 镜像

   • 打开终端，进入仓库根目录。
   • 运行命令 'docker build -t programmable-email .' 构建 Docker 镜像。

4. 验证 Docker 镜像 (可选)

   • 运行命令 'docker run -i --rm programmable-email' 验证镜像是否可以正常运行。

服务器配置

要将此 MCP 服务器配置到 Claude 客户端，您需要编辑 Claude 的配置文件 'claude_desktop_config.json'。该文件通常位于 '~/Library/Application Support/Claude' 目录下（macOS）。

在 'claude_desktop_config.json' 文件中，找到或创建 'mcpServers' 字段，并添加以下配置信息：

{
  "mcpServers": {
    "programmable-email": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "programmable-email"]
    }
  }
}

配置参数说明：

• '"programmable-email"': MCP 服务器的名称，可以自定义，在 Claude 客户端中通过此名称引用。
• '"command": "docker"': 启动 MCP 服务器的命令，这里使用 Docker 运行镜像。
• '"args": ["run", "-i", "--rm", "programmable-email"]': 'docker run' 命令的参数。
  • 'run': Docker 运行命令。
  • '-i': 保持标准输入 (STDIN) 打开，即使没有连接。
  • '--rm': 容器退出后自动删除容器。
  • 'programmable-email': 要运行的 Docker 镜像名称，与构建镜像时指定的名称一致。

基本使用方法

1. 启动 Claude 客户端

   • 重新启动或打开 Claude 桌面客户端，使配置生效。

2. 向 Claude 发出指令

   • 在 Claude 中，您可以尝试以下指令来测试邮件读取功能：
     • 'Retrieve my recent unread emails.' (检索我最近的未读邮件。)
     • 'Get the latest 5 emails in my inbox.' (获取我收件箱中最新的 5 封邮件。)
     • 您还可以根据工具描述中的参数，更精确地控制邮件检索条件。

注意： 由于该项目还在开发中，目前只实现了部分邮件读取功能。发送邮件等功能仍在开发中。请参考仓库的 TODO 列表了解更多信息。