Proton Drive MCP

一个模型上下文协议（MCP）服务器，使像Claude Desktop、Cursor和其他兼容MCP的客户端能够与你的Proton Drive文件进行交互。

✨ 特性

• 📁 列出文件和文件夹 在你的Proton Drive中
• 📄 读取文件内容 直接读取
• ✏️ 创建和写入文件 到Proton Drive
• 🗑️ 删除文件和文件夹
• 📂 创建新文件夹
• 🔄 跨平台支持 （Windows, macOS, Linux）
• 🔒 安全 - 通过本地文件系统工作，无需凭据
• 🚀 易于安装 - 只需npm安装并配置

📋 先决条件

• Node.js 16或更高版本
• 已安装并同步的Proton Drive桌面应用
• Claude Desktop、Cursor或其他兼容MCP的客户端

🚀 快速开始

1. 从npm安装（推荐）

npm install -g proton-drive-mcp

2. 或者从源码安装

git clone https://github.com/anyrxo/proton-drive-mcp.git
cd proton-drive-mcp
npm install
npm run build

⚙️ 配置

查找你的Proton Drive路径

MCP会尝试自动检测你的Proton Drive位置，但你也可以手动设置：

• macOS: ~/Library/CloudStorage/ProtonDrive-[email]-folder
• Windows: C:\Users\[username]\Proton Drive
• Linux: ~/ProtonDrive

Claude Desktop

添加到你的Claude Desktop配置：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "proton-drive": {
      "command": "node",
      "args": ["path/to/proton-drive-mcp/dist/index.js"]
    }
  }
}

Cursor

添加到你的Cursor设置：

{
  "mcp.servers": {
    "proton-drive": {
      "command": "node",
      "args": ["path/to/proton-drive-mcp/dist/index.js"]
    }
  }
}

自定义Proton Drive路径

如果你的Proton Drive位于非标准位置：

{
  "mcpServers": {
    "proton-drive": {
      "command": "node",
      "args": ["path/to/proton-drive-mcp/dist/index.js"],
      "env": {
        "PROTON_DRIVE_PATH": "/custom/path/to/ProtonDrive"
      }
    }
  }
}

🎯 使用示例

配置完成后，你可以向你的AI助手询问：

• "列出我的Proton Drive中的所有文件"
• "创建一个名为notes.txt的新文件，并添加一些内容"
• "读取Documents/report.pdf的内容"
• "创建一个名为Projects的新文件夹"
• "删除old-notes.txt文件"

🛠️ 可用工具

MCP提供以下工具：

工具	描述
check_mount	验证Proton Drive是否可访问
list_files	列出目录的内容
read_file	读取文件内容
write_file	创建或覆盖文件
delete_file	删除文件或文件夹
create_folder	创建新的目录

🧪 测试

测试MCP是否正常工作：

# 检查是否检测到Proton Drive
npm run test:connection

# 运行所有测试
npm test

🔧 故障排除

Proton Drive未找到

1. 确保Proton Drive桌面应用正在运行
2. 检查你的文件是否已同步
3. 手动设置PROTON_DRIVE_PATH环境变量

权限错误

• 确保MCP对你的Proton Drive文件夹有读写权限
• 在macOS上，你可能需要在系统偏好设置中授予权限

工具未显示在Claude/Cursor中

1. 在配置后重启你的AI客户端
2. 检查日志是否有任何错误消息
3. 验证MCP路径是否正确

📝 开发

# 安装依赖
npm install

# 开发模式运行
npm run dev

# 生产构建
npm run build

# 运行测试
npm test

🤝 贡献

欢迎贡献！请：

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 如适用，请添加测试
5. 提交拉取请求

📄 许可

MIT许可 - 详见LICENSE文件

🔒 安全

• 所有操作都在你的本地文件系统上执行
• 不将数据发送到外部服务器
• 保留Proton的端到端加密
• 路径验证防止目录遍历攻击

🐛 已知问题

• 大文件（>10MB）可能需要时间来读取
• 当前不支持读取二进制文件
• 文件名中的某些特殊字符可能会导致问题

📮 支持

• 问题：GitHub Issues
• 讨论：GitHub Discussions

---

为Proton Drive社区制作，充满❤️