AI导哈

Proton Drive文件交互协议

一个Model Context Protocol (MCP)服务器，使AI助手如Claude Desktop、Cursor等MCP兼容客户端能够与您的Proton Drive文件进行交互。

  • by anyrxo
  • JavaScript
  • 本地部署
  • 17 星标
  • 更新于
在 GitHub 查看 anyrxo/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提供以下工具：

工具 说明
check_mount 验证质子驱动器是否可用
list_files 列出目录的内容
read_file 读取文件内容
write_file 创建或覆盖文件
delete_file 删除文件或文件夹
create_folder 创建新目录

🧪 测试

测试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）可能需要时间才能读取
  • 二进制文件尚不支持读取
  • 文件名中的某些特殊字符可能会导致问题

📮 支持

制作❤️ 质子驱动社区

相关 MCP