Proton Drive MCP

🚀 Proton Drive MCP

Proton Drive MCP 是一個模型上下文協議（MCP）服務器，它能讓 Claude Desktop、Cursor 等 AI 助手以及其他兼容 MCP 的客戶端與你的 Proton Drive 文件進行交互。

🚀 快速開始

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 中的文件和文件夾。
• 📄 直接讀取文件內容：能直接讀取文件內容。
• ✏️ 創建和寫入文件：可在 Proton Drive 中創建和寫入文件。
• 🗑️ 刪除文件和文件夾：支持刪除文件和文件夾。
• 📂 創建新文件夾：能創建新的文件夾。
• 🔄 跨平臺支持：支持 Windows、macOS、Linux 等平臺。
• 🔒 安全可靠：通過本地文件系統運行，無需憑證。
• 🚀 易於安裝：只需通過 npm install 並進行配置即可。

📋 前提條件

• Node.js 16 或更高版本。
• 已安裝並同步 Proton Drive 桌面應用。
• 安裝了 Claude Desktop、Cursor 或其他兼容 MCP 的客戶端。

⚙️ 配置

查找 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 提供了以下工具：

🧪 測試

測試 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 社區用心打造 ❤️