Protonmail MCP Server

Protonmail MCP 服务

此 MCP 服务由 amotivv, inc. 提供，该公司是 Memory Box 的创建者。

此 MCP 服务使用 Protonmail 的 SMTP 服务提供电子邮件发送功能。它允许 Claude Desktop 和 Cline VSCode 扩展使用你的 Protonmail 凭据代你发送电子邮件。

兼容性

此 MCP 服务兼容：

• Claude Desktop App：Claude 的独立桌面应用程序
• Cline VSCode Extension：适用于 Visual Studio Code 的 Claude 扩展

由于两个平台都使用 Model Context Protocol（MCP）标准，因此相同的实现适用于这两个平台。

功能

• 向一个或多个收件人发送电子邮件
• 支持抄送和密送收件人
• 支持纯文本和 HTML 格式的电子邮件内容
• 完善的错误处理和日志记录

配置

需要在 Claude Desktop 和 Cline 的 MCP 设置文件中设置以下环境变量：

Claude Desktop 配置

文件位置：/Users/your-username/Library/Application Support/Claude/claude_desktop_config.json

Cline VSCode Extension 配置

文件位置：/Users/your-username/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

两个配置文件都需要以下环境变量：

• PROTONMAIL_USERNAME：你的 Protonmail 电子邮件地址
• PROTONMAIL_PASSWORD：你的 Protonmail SMTP 密码（不是常规登录密码）
• PROTONMAIL_HOST：SMTP 服务主机名（默认值：smtp.protonmail.ch）
• PROTONMAIL_PORT：SMTP 服务端口（默认值：STARTTLS 使用 587，SSL/TLS 使用 465）
• PROTONMAIL_SECURE：是否使用安全连接（默认值：端口 587 时为 "false"，端口 465 时为 "true"）
• DEBUG：启用调试日志（设为 "true" 可查看详细日志，设为 "false" 可隐藏日志）

有关 Protonmail SMTP 服务的详细信息（包括如何获取 SMTP 密码），请参阅 Protonmail 官方 SMTP 文档。

用法

配置完成后，可以使用以下工具通过 MCP 服务发送电子邮件：

send_email

使用你的 Protonmail SMTP 帐户发送电子邮件。

参数：

• to：收件人电子邮件地址。多个地址可用逗号分隔。
• subject：电子邮件主题
• body：电子邮件正文内容（可以是纯文本或 HTML）
• isHtml：（可选）正文是否包含 HTML 内容（默认值：false）
• cc：（可选）抄送收件人，用逗号分隔
• bcc：（可选）密送收件人，用逗号分隔

示例：

<use_mcp_tool>
<server_name>protonmail-mcp</server_name>
<tool_name>send_email</tool_name>
<arguments>
{
  "to": "[email protected]",
  "subject": "Test Email from Cline",
  "body": "This is a test email sent via the Protonmail MCP server.",
  "cc": "[email protected]"
}
</arguments>
</use_mcp_tool>

故障排除

如果 MCP 服务出现问题，请检查以下事项：

1. 确保两个配置文件中的 Protonmail SMTP 凭据正确
2. 确认防火墙未阻止 SMTP 端口
3. 检查 Protonmail 帐户是否存在发送限制
4. 查看日志中的错误消息：
   • Claude Desktop 应用日志
   • Cline VSCode 扩展输出面板
5. 修改配置后，重启 Claude Desktop 应用或重新加载 VSCode 窗口

开发

构建项目：

cd protonmail-mcp
npm install
npm run build

要修改服务，请编辑 src 目录中的文件，然后重新构建项目。

安装

此 MCP 服务可安装到 Claude Desktop 和 Cline VSCode 扩展中。以下是将其添加到环境中的方法：

手动安装

1. 将此代码库克隆到本地计算机：

   git clone https://github.com/your-username/protonmail-mcp.git
   cd protonmail-mcp
   

2. 安装依赖并构建项目：

   npm install
   npm run build
   

3. 将服务配置添加到 MCP 设置文件中（参见上文的配置部分）

使用 Cline 从 GitHub 安装

Cline 可以自动从 GitHub 代码库克隆并构建 MCP 服务。使用此功能的步骤如下：

1. 向 Cline 提供 GitHub 代码库 URL
2. 让 Cline 克隆并构建服务
3. 提供任何必要的配置信息（例如 SMTP 凭据）

有关使用 Cline 从 GitHub 安装 MCP 服务的详细说明，请参阅 Cline MCP 服务安装文档。

资源

• Protonmail SMTP 文档 - 使用 Protonmail SMTP 服务的官方指南
• Nodemailer 文档 - 此 MCP 服务使用的邮件发送库
• Model Context Protocol 文档 - MCP 协议文档
• Claude 桌面应用 - 下载 Claude 桌面应用
• Cline VSCode 扩展 - 安装 Cline 的 VSCode 扩展
• Cline MCP 文档 - Cline 的 MCP 服务文档
• 从 GitHub 安装 MCP 服务 - 从 GitHub 代码库安装 MCP 服务的指南

查找更多 MCP 服务

你可以在以下代码库和目录中找到更多 MCP 服务：

• 官方 MCP 服务代码库 - 官方 MCP 服务集合
• Awesome-MCP 服务代码库 - 社区精选的 MCP 服务列表
• mcpservers.org - MCP 服务在线目录
• mcp.so - 另一个用于发现 MCP 服务的目录

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。