使用说明
质子微控制器
MCP服务器 质子隐私套房 --邮件、通行证、驱动器、日历和VPN。用于Claude和其他MCP兼容AI代理的36个工具。
由Scott Jorgensen和Jorgencaw(人工智能代理)为 jorgenclaw.ai 主权堆栈。
需求
- 质子邮件桥 --在主机上运行(提供对Proton Mail的IMAP/SMTP访问)
- 传递cli — Proton Pass命令行界面 用于密码管理器工具
- Node.js 22+
安装
git clone https://github.com/jorgenclaw/proton-mcp.git
cd proton-mcp
npm install
创建一个 .env 示例中的文件:
cp .env.example .env
# Edit .env with your Proton Bridge credentials
配置
PROTON_BRIDGE_HOST=127.0.0.1
PROTON_BRIDGE_IMAP_PORT=1143
PROTON_BRIDGE_SMTP_PORT=1025
PROTON_BRIDGE_USER=your@proton.me
PROTON_BRIDGE_PASS=your-bridge-password
PROTON_BRIDGE_FROM=your@proton.me
Bridge密码位于Proton Bridge中→ 设置→ 您的账户→ IMAP/SMTP密码(这不是您的Proton帐户密码)。
用法
使用克劳德桌面
添加到您的Claude桌面配置(~/.config/claude/claude_desktop_config.json):
{
"mcpServers": {
"proton": {
"command": "node",
"args": ["/path/to/proton-mcp/index.js"],
"env": {
"PROTON_BRIDGE_HOST": "127.0.0.1",
"PROTON_BRIDGE_IMAP_PORT": "1143",
"PROTON_BRIDGE_SMTP_PORT": "1025",
"PROTON_BRIDGE_USER": "your@proton.me",
"PROTON_BRIDGE_PASS": "your-bridge-password",
"PROTON_BRIDGE_FROM": "your@proton.me"
}
}
}
}
使用NanoClaw
在容器配置中作为MCP服务器安装。请参阅 NanoClaw文档 用于MCP服务器设置。
独立
node --env-file=.env index.js
服务器通过MCP stdio协议进行通信。
工具(36)
邮件(16个工具)
| 工具 | 说明 |
|---|---|
mail__get_unread |
获取未读邮件计数和摘要 |
mail__list_messages |
列出收件箱中的最新邮件 |
mail__get_message |
按ID获取完整消息内容 |
mail__search_messages |
在收件箱、已发送、草稿、存档中搜索 |
mail__get_thread |
获取一个线程中的所有消息 |
mail__send_message |
发送新电子邮件 |
mail__reply_message |
回复消息(保留线程) |
mail__forward_message |
将邮件转发给其他收件人 |
mail__mark_message |
标记为已读/未读 |
mail__star_message |
添加/取消添加消息 |
mail__delete_message |
永久删除邮件 |
mail__move_message |
移动到其他文件夹 |
mail__list_folders |
列出所有邮件文件夹 |
mail__list_folder_messages |
列出特定文件夹中的邮件 |
mail__get_attachments |
下载邮件附件 |
mail__get_thread |
重建完整的对话线索 |
通行证(9个工具)
| 工具 | 说明 |
|---|---|
pass__list_vaults |
列出可用的质子通行证保险库 |
pass__list_items |
列出保管库中的项目(不显示密码) |
pass__search_items |
按关键字搜索项目(不显示密码) |
pass__get_item |
获取完整凭据(用户名、密码、URL) |
pass__create_item |
存储新的登录凭据 |
pass__update_item |
更新现有凭据 |
pass__trash_item |
将物品移至回收站 |
pass__get_totp |
为2FA生成当前TOTP代码 |
pass__generate_password |
生成安全的随机密码 |
驱动器(6个工具)
| 工具 | 说明 |
|---|---|
drive__list |
列出文件和文件夹 |
drive__download |
下载文件 |
drive__upload |
上传文件 |
drive__upload_folder |
上传整个文件夹 |
drive__mkdir |
创建目录 |
drive__delete |
删除文件或文件夹 |
日历(5个工具)
| 工具 | 说明 |
|---|---|
calendar__list_events |
列出即将举行的活动 |
calendar__get_event |
获取活动详细信息 |
calendar__create_event |
创建新事件 |
calendar__update_event |
更新现有事件 |
calendar__delete_event |
删除事件 |
VPN(1个工具)
| 工具 | 说明 |
|---|---|
vpn__status |
检查Proton VPN连接状态 |
安全说明
- 质子桥密码 不是您的Proton帐户密码,而是特定于Bridge的IMAP/SMTP密码
- pass__列表_项目 和 pass__搜索_项目 永远不要暴露密码或TOTP种子
- 仅 pass__get_item 返回实际密码——请谨慎使用
- 这
.env文件包含凭据--不受版本控制
许可证
麻省理工学院——见 许可证