Seafile

Seafile MCP

AI アシスタントが Seafile 内のファイルを閲覧、検索、読み取り、整理できます。
ブラウザーでサインインすれば、Mac 上のどの MCP クライアントからでも利用できます。依存関係はありません。

最新リリースをダウンロード · インストール · できること · 安全性

開発の背景

Seafile は、セルフホスト可能なファイル同期・共有サーバーです。この MCP サーバーを使うと、コネクターのようにアシスタントから Seafile を操作できます。

• ブラウザーでサインイン。 初回は、Seafile 自身のログインページがブラウザーウィンドウで開きます。パスワード、SSO、二要素認証など、サーバーで使っている方法でサインインできます。アシスタントにパスワードが伝わることはありません。トークンは macOS キーチェーンに保存されます。
• あらゆる MCP クライアントに対応。 デスクトップチャットアプリ、ローカルモデルアプリ、コーディングエージェントなど、stdio 経由で MCP サーバーを起動するものなら何でも使えます。
• インストール不要。 Node、Python、Homebrew は不要です。Mac 標準の curl とキーチェーンを使い、JavaScript for Automation 上で動作します。
• 権限プロンプトは 30 個ではなく 2 個。 すべての操作は read ツールと write ツールにまとめられています。
• 小型のローカルモデルにも対応。 引数に柔軟性があり（library の代わりに repo、path の代わりに folder、"true"、ls、mv、rm のような短いアクション名）、間違いがあると、修正方法をわかりやすく案内します。

できること

インストール

macOS 14 以降と MCP クライアントが必要です。

あらゆる MCP クライアント

コードを取得し（git clone を実行するか、最新リリースから .mcpb を展開）、クライアントの設定にサーバーを追加します。

{
  "mcpServers": {
    "seafile": {
      "command": "/usr/bin/osascript",
      "args": ["-l", "JavaScript", "/path/to/seafile-mcp/server/seafile-mcp.js"],
      "env": { "SEAFILE_URL": "https://cloud.example.com" }
    }
  }
}

./install.sh --print --server https://cloud.example.com を実行すると、正しいパスを含むこのブロックが表示されます。

Claude Desktop（ワンクリック）

最新リリースから seafile-mcp.mcpb をダウンロードし、ダブルクリックして Install をクリックします。設定は Settings → Extensions にあります。

設定

サーバーでは、クライアントによるブラウザーサインインを許可する必要があります（Seafile デスクトップクライアントが使用する設定と同様に、seahub_settings.py で CLIENT_SSO_VIA_LOCAL_BROWSER = True を設定します）。

安全性

• 削除した項目はライブラリのゴミ箱に移動し、復元できます。また、削除した項目が消失してしまう履歴を保持しないライブラリでは、サーバーは削除を拒否します。
• 予告なく上書きされることはありません。 既存のファイルをアップロードまたは書き込みで上書きするには、replace: true が必要です。古いファイルはファイル履歴に残ります。ダウンロードでローカルファイルが上書きされることはありません。
• ローカルフォルダーは1つです。 アップロード元とダウンロード先は、設定で指定したローカルフォルダーに限られます。プロンプトインジェクションによる「~/.ssh/id_rsa をアップロードして」という指示は拒否されます。
• アップロード、書き込み、移動、コピー、削除、共有リンクにはドライランがあります。
• 同じ操作が意図せず繰り返されることはありません。 15分以内に同じ内容を書き込もうとすると、意図的に再度指示しない限り拒否されます。
• 処理が停止したままになることはありません。 時間がかかりすぎる呼び出しは、明確なエラーとともに停止します。ping と tools/list は常に応答します。
• ファイルに隠された指示に注意してください。 アシスタントが読み取った内容はすべてコンテキストの一部になります。write は手動承認のままにするか、読み取り専用モードを有効にしてください。
• 読みやすいファイルは1つです。 サーバー全体は server/seafile-mcp.js にあります。

暗号化されたライブラリは一覧表示できますが、読み取り、アップロード、共有はできません。これらの操作には Seafile のウェブページまたはデスクトップクライアントを使用してください。

/usr/bin/osascript -l JavaScript tests/unit.js server/seafile-mcp.js   # fake Seafile, fake Keychain
python3 tests/protocol.py                                              # JSON-RPC, worker, installer
./test.sh                                                              # real server: signs in, lists libraries

ライセンス

MIT © IPSupport LLC