AI导哈

邮件管理服务器

一个为AI助手提供访问Proton Mail账户的MCP服务器，支持读取、搜索、发送和管理邮件。

  • by capsenz
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 capsenz/proton-mcp

使用说明

Proton邮件MCP服务器

MCP（模型上下文协议）服务器，为AI助手提供对Proton Mail帐户的访问权限。这允许LLM通过Proton Mail Bridge读取、搜索、发送和管理电子邮件。

特性

  • 列出文件夹 -查看所有包含邮件计数的邮箱文件夹
  • 搜索电子邮件 -按发件人、主题、日期范围或关键字查找电子邮件
  • 阅读电子邮件 -按ID获取完整的电子邮件内容
  • 发送邮件 -撰写和发送新消息
  • 回复电子邮件 -回复现有电子邮件线程
  • 移动电子邮件 -通过在文件夹之间移动电子邮件来组织电子邮件

先决条件

  1. Proton Mail高级帐户 -质子桥所需
  2. 质子桥安装并运行 -下载自 质子邮件
  3. Bun运行时 - 安装Bun

安装

1.克隆并安装依赖项

git clone https://github.com/capsenz/proton-mcp.git
cd proton-mcp
bun install

2.配置环境变量

复制示例环境文件并填写您的凭据：

cp .env.example .env

编辑 .env 使用您的质子桥证书：

PROTON_HOST=127.0.0.1
PROTON_IMAP_PORT=1143
PROTON_SMTP_PORT=1025
PROTON_USER=your@protonmail.com
PROTON_PASS=your-bridge-password

3.获取质子桥证书

要查找您的网桥密码：

  1. 打开 质子桥 应用
  2. 你应该看到你的密码
  3. 复制此密码（它与您的Proton Mail登录密码不同）

你的 PROTON_USER 应该是您的完整Proton邮件地址（例如。， you@proton.me).

4.配置克劳德桌面

将MCP服务器添加到您的Claude Desktop配置中：

  1. 打开 ~/Library/Application Support/Claude/claude_desktop_config.json
  2. 将以下内容添加到 mcpServers 对象：
{
  "mcpServers": {
    "proton-mail": {
      "command": "bun",
      "args": ["/full/path/to/proton-mcp/index.ts"],
      "env": {
        "PROTON_HOST": "127.0.0.1",
        "PROTON_IMAP_PORT": "1143",
        "PROTON_SMTP_PORT": "1025",
        "PROTON_USER": "your@protonmail.com",
        "PROTON_PASS": "your-bridge-password"
      }
    }
  }
}

重要提示： 替换 /full/path/to/proton-mcp/index.ts 安装的实际绝对路径。

  1. 保存文件并 重新启动克劳德桌面

用法

配置后，您可以要求Claude与您的Proton Mail进行交互：

  • “检查我的电子邮件中是否有约翰的消息”
  • “发送电子邮件至team@example.com随着项目的更新”
  • “搜索有关上周会议的电子邮件”
  • “将所有垃圾邮件移至垃圾箱”

发展

在开发模式下运行服务器：

bun run index.ts

故障排除

桥接失败

  • 确保质子桥正在运行并已连接
  • 验证中的端口 .env 匹配您的网桥设置（默认值：IMAP 1143，SMTP 1025）
  • 检查您的网桥密码是否正确

Claude中未加载MCP服务器

  • 验证路径 index.ts 是绝对的（以开头 /)
  • 确保在配置中正确设置了所有环境变量
  • 更改配置后重新启动Claude Desktop

权限错误

  • 确保 .env 文件具有读取权限
  • 验证Bun是否可以执行TypeScript文件

安全说明

  • 您的网桥密码以纯文本形式存储在 .env 以及克劳德的配置
  • 保持这些文件的私密性和安全性
  • 永远不要承诺你的 .env 文件到版本控制（它已经在 .gitignore)

备注

该项目与Proton公司没有任何关联。

相关 MCP