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)：读取并删除在指定秒数内收到的最新电子邮件。