首页/其他工具与集成/gmail-attachment-mcp-server

gmail-attachment-mcp-server

查看源码
2025-5-12
Words 501Read Time 2 min
Score:85

一个基于MCP协议的服务器,用于从Gmail下载附件,提供简单的API接口。

Gmail 附件 MCP 服务器

一个提供微服务的服务器,用于通过消息控制协议(MCP)下载 Gmail 附件。

概述

本项目实现了一个 FastMCP 服务器,允许你通过消息 ID 从 Gmail 邮件中下载附件。它使用 IMAP 连接到 Gmail 并获取附件。

功能

  • 使用消息 ID 从 Gmail 邮件中下载附件
  • 通过 SSL 加密的 IMAP 安全连接到 Gmail
  • 通过环境变量配置凭证
  • 通过 MCP 提供简单的 API 接口

先决条件

  • Python 3.7 或更高版本
  • 需要安装 uv
  • 已启用 IMAP 的 Gmail 账户
  • Gmail 的应用密码(如果启用了两步验证)

安装

配置

设置以下环境变量:
注意: 对于 Gmail,你应该使用应用密码而不是常规密码。更多信息请参阅 Google 的文档

使用

启动服务器

使用工具

服务器暴露了一个 download_attachments_tool 工具,接受以下参数:
  • message_id: Gmail 消息 ID,十六进制格式
  • download_folder: (可选)下载附件的文件夹(默认为 "./attachments")
该函数返回下载的附件文件的路径列表。

与 MCP 检查器一起使用

与 Goose 一起使用

API 参考

download_attachments_tool

通过消息 ID 从 Gmail 邮件中下载附件。

参数:

  • message_id: Gmail 消息 ID,十六进制格式
  • download_folder: (可选)下载附件的文件夹(默认为 "./attachments")

返回值:

  • 包含下载附件文件路径的字符串列表

许可证

MIT
上一篇
MCPCalendar
下一篇
mcp-server-port-cleaner