mcpField
S
synology-file-station

synology-file-station

github.com/tiangong-ai生産性1189 回インストール1 週間前に更新
リポジトリ

synology-file-station について

Synology File Stationは、PythonのコマンドラインスクリプトでSynology上のファイル操作を行うスキルです。環境変数から認証情報を読み込み、自動化パイプライン向けに構造化JSONを返します。

主な機能

  1. 01共有フォルダーとファイルの参照
  2. 02ファイルやディレクトリの検索
  3. 03作成、名前変更、移動、コピー、削除
  4. 04ファイルのアップロードとダウンロード
  5. 05アーカイブの展開とバックグラウンドタスク制御
  6. 06構造化JSON結果の出力

活用シーン

  1. 01Synologyのファイル操作の自動化
  2. 02NAS上のファイル検索
  3. 03パイプラインでのファイル転送
  4. 04変更可能なパスの制限

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tiangong-ai/agent-skills --skill synology-file-station

インストール後、Claude Code で/synology-file-stationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
assets/
config.example.env
references/
commands.md
env.md
scripts/
synology_file_station.py

詳細

Synology File Station

主な目的

  • 1 つの CLI スクリプトで、Synology File Station の主要なファイル操作を実行します。
  • 接続資格情報はハードコードせず、環境変数から読み込みます。
  • 自動化パイプラインに適した JSON 出力を返します。

ワークフロー

  1. 環境変数を準備します（references/env.md と assets/config.example.env を参照）。
  2. 設定を検証します。
python3 scripts/synology_file_station.py check-config
  1. 必要に応じて接続を確認します。
python3 scripts/synology_file_station.py check-config --probe
  1. 必要なファイル操作コマンドを実行します（references/commands.md を参照）。

主な操作

  • 読み取り／閲覧：info、list-shares、list、get-info
  • 検索：search-start、search-list、search-stop、search-clean
  • ディレクトリ／ファイルの変更：mkdir、rename、copy、move、delete
  • 転送：upload、download
  • アーカイブのワークフロー：extract（compress は一時的に利用できません）
  • バックグラウンドタスクの制御：background-list、task-status、task-stop

環境変数の仕様

必須の環境変数：

  • SYNOLOGY_BASE_URL
  • SYNOLOGY_USERNAME
  • SYNOLOGY_PASSWORD

任意の環境変数：

  • SYNOLOGY_VERIFY_SSL
  • SYNOLOGY_TIMEOUT
  • SYNOLOGY_SESSION
  • SYNOLOGY_READONLY（デフォルトは false。変更コマンドをブロックするには true を設定します）
  • SYNOLOGY_MUTATION_ALLOW_PATHS（変更可能なパスの許可リスト。任意）

出力の仕様

  • 成功時：type=status と操作固有のフィールドを含む JSON オブジェクト。
  • 失敗時：type=error と構造化されたエラーメタデータを含む JSON オブジェクト。
  • 終了コード：
    • 0：成功
    • 1：実行時／API エラー
    • 2：環境変数の設定が無効

参考資料

  • references/env.md
  • references/commands.md

アセット

  • assets/config.example.env

スクリプト

  • scripts/synology_file_station.py

コメント

Markdown 対応