Proton Drive MCP

质子驱动MCP

一个模型上下文协议（MCP）服务器，使Claude Desktop、Cursor和其他MCP兼容客户端等AI助手能够与您的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

⚙️ 配置

寻找您的质子驱动路径

MCP将尝试自动检测您的质子驱动器位置，但您也可以手动设置：

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

克劳德桌面版

添加到您的Claude Desktop配置中：

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

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

光标

添加到光标设置中：

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

自定义质子驱动路径

如果您的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的新文件夹”
• “删除旧notes.txt文件”

🛠️ 可用工具

MCP提供以下工具：

🧪 测试

测试MCP是否工作：

# Check if Proton Drive is detected
npm run test:connection

# Run all tests
npm test

🔧 故障排除

未找到质子驱动器

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

权限错误

• 确保MCP具有对Proton Drive文件夹的读/写访问权限
• 在macOS上，您可能需要在“系统首选项”中授予权限

工具未显示在Claude/Cursor中

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

📝 发展

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test

🤝 贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

📄 许可证

MIT许可证-请参阅 许可证 文件

🔒 安全

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

🐛 已知问题

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

📮 支持

• 问题：
• 讨论：

______________________________________________________________________

制作❤️ 质子驱动社区