Proton Drive MCP

🚀 Proton Drive MCP

このModel Context Protocol (MCP)サーバーは、Claude DesktopやCursorなどのAIアシスタントや、その他のMCP互換クライアントが、あなたのProton Driveのファイルとやり取りできるようにします。

✨ 主な機能

• 📁 Proton Drive内のファイルとフォルダを一覧表示
• 📄 直接ファイル内容を読み取り
• ✏️ Proton Driveにファイルを作成および書き込み
• 🗑️ ファイルとフォルダを削除
• 📂 新しいフォルダを作成
• 🔄 クロスプラットフォーム対応 (Windows、macOS、Linux)
• 🔒 安全 - ローカルファイルシステムを介して動作し、資格情報は不要
• 🚀 インストールが簡単 - npm install を実行して設定するだけ

📋 前提条件

• 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は以下のツールを提供します。

🧪 テスト

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コミュニティのために愛を込めて作成されました。