Gmail邮件管理服务器

一个通过POP3协议提供读取和删除Gmail账户邮件的MCP服务器。

  • by curif
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 curif/pop3_gmail_mcp

使用说明

Gmail POP3 MCP服务器

一种MCP服务器,提供通过POP3从单个Gmail帐户读取和删除电子邮件的工具。

设置

  1. 在Gmail帐户设置中启用POP3。
  2. 在您的Google帐户安全设置中创建应用程序密码。
  3. 创建一个 .env 文件与位于同一目录中 docker-compose.yml 具有以下变量:
GMAIL_ADDRESS=your.email@gmail.com
GMAIL_APP_PASSWORD=your_app_password_here
# Optional: Change the POP3 server/port if you are not using standard Gmail settings
# EMAIL_HOST=pop.gmail.com
# EMAIL_PORT=995

运行服务器

使用Docker Compose

docker-compose up -d

使用Docker手动构建和运行

如果你更喜欢在没有Docker Compose的情况下自己构建镜像:

# Build the image
docker build -t pop3_gmail_mcp .

# Run the container
docker run -d --name mcp-gmail-client \
  --env-file .env \
  -p 9087:8087 \
  pop3_gmail_mcp

本地运行

pip install -r requirements.txt
python main.py run-mcp-server --port 8087

在Claude桌面或光标中配置

将此添加到您的 claude_desktop_config.json 或同等产品:

{
  "mcpServers": {
    "gmail_client": {
      "command": "docker",
      "args": ["exec", "-i", "mcp-gmail-client-1", "python", "main.py", "run-mcp-server"]
    }
  }
}

(注意:确保容器名称 mcp-gmail-client-1 匹配您实际运行的容器)。

可用工具

  • get_emails(after_datetime, limit):检索最近的电子邮件。
  • get_email(email_id):检索特定电子邮件的完整内容。
  • delete_email(email_id):删除特定电子邮件。
  • email_read_and_delete(after_datetime):读取并删除最近的电子邮件。
  • read_and_delete_recent_email(period_in_seconds):读取并删除在指定秒数内收到的最新电子邮件。