mcpField
C
calibredb

calibredb

github.com/lvtd-llcドキュメント175 回インストール7 週間前に更新
リポジトリ

calibredb について

CalibreDBスキルは、Calibreライブラリをコマンドラインで操作するための手順を示し、書籍レコードの確認や管理を行う人を対象とします。ライブラリの場所を特定し、読み取り専用の確認から始め、破壊的な操作の前に意図を確認します。

主な機能

  1. 01ローカルライブラリまたはContent serverの指定
  2. 02書籍検索とメタデータ確認
  3. 03書籍追加とフィールド更新
  4. 04ライブラリの健全性チェック
  5. 05読み取り専用操作と破壊的操作の区別

活用シーン

  1. 01書籍を検索してレコードIDを取得
  2. 02書籍情報と形式を確認
  3. 03メタデータ更新や書籍ファイル追加
  4. 04ライブラリの健全性を確認

インストール

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

$npx skills add https://github.com/lvtd-llc/skills --skill calibredb

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

同梱ファイル

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

references/
command-matrix.md
safe-workflows.md
scripts/
list_books_json.py

詳細

CalibreDB

Calibre ライブラリに対するすべてのコマンドライン操作で、このスキルを使用します。

ライブラリのパス

  • Calibre ライブラリの場所はユーザーごとに異なります。コマンドを実行する前に、対象のライブラリのパスまたは Content サーバーの URL を特定してください。
  • すべてのコマンドで、明示的なパスを指定することを優先してください：--with-library "$CALIBRE_LIBRARY"。
  • ユーザーからライブラリのパスが提供されていない場合は、先にパスを尋ねるか、ローカル環境に既存の Calibre ライブラリがないか確認してください。
  • 機械可読な出力には、--for-machine または JSON に対応したサブコマンドを使用してください。

安全性モデル

まず読み取り専用の操作から始め、必要な場合にのみ変更操作へ移行してください。

読み取り専用（デフォルトで安全）
  • list
  • search
  • show_metadata
  • custom_columns
  • list_categories
  • check_library
  • fts_search
  • fts_index status
変更操作（破壊的または取り消し不能な操作では意図を確認）
  • 明確な意図があれば通常は安全：add、set_metadata、set_custom、add_format、embed_metadata、backup_metadata
  • 破壊的な操作の前に確認：remove、remove_format、remove_custom_column、restore_database、ライブラリ全体に対する fts_index reindex

基本的なワークフロー

  1. 対象のライブラリを特定し、--with-library を設定します。
  2. search（または list --search）で関連する書籍 ID を見つけます。
  3. show_metadata または list --for-machine でレコードを確認します。
  4. 必要最小限の変更を適用します。
  5. その後、list、search、show_metadata で検証します。

コマンドの使用例

1) 書籍の一覧表示
export CALIBRE_LIBRARY="/path/to/Calibre Library"
calibredb list --with-library "$CALIBRE_LIBRARY" --fields id,title,authors,formats --limit 20

機械可読な出力：

calibredb list --with-library "$CALIBRE_LIBRARY" --fields id,title,authors,tags,formats --for-machine
2) 検索して ID を取得
calibredb search --with-library "$CALIBRE_LIBRARY" "title:python"

後続のコマンドでは ID を使用します。

3) メタデータの表示
calibredb show_metadata --with-library "$CALIBRE_LIBRARY" 123

OPF 形式の場合：

calibredb show_metadata --with-library "$CALIBRE_LIBRARY" --as-opf 123
4) メタデータフィールドの更新
calibredb set_metadata --with-library "$CALIBRE_LIBRARY" 123 \
  --field title:"Example Book" \
  --field tags:"python,reference"
5) 書籍の追加／エクスポート
calibredb add --with-library "$CALIBRE_LIBRARY" "/path/to/book.epub"
calibredb export --with-library "$CALIBRE_LIBRARY" 123 --to-dir "/tmp/export"
6) ライブラリの健全性チェック
calibredb check_library --with-library "$CALIBRE_LIBRARY"

Content サーバーの使用

実行中の Calibre Content サーバーを対象にするには：

calibredb list --with-library "http://hostname:8080/#library_id" --username <user> --password <pass>

ドキュメントによると、サーバーのライブラリを一覧表示するには、特別な #- ライブラリ ID を使用します。

セキュリティに関する注意：--password <pass> のリテラル値はプロセス引数として渡されるため、共有マシンではプロセス一覧ツールを使って他のユーザーから見える場合があります。パスワードマネージャーからパスワードをパイプで渡して --password '<stdin>' を使用するか、リポジトリの外に保存した 0600 の認証情報ファイルを使って --password '<f:/path/to/file>' を使用することを推奨します。認証が必要な Content サーバーのコマンドでは、ローカルホストまたは信頼できるホストを優先し、シェル履歴、ログ、タスクの記録から認証情報を除去してください。

参照ファイル

  • コマンド一覧とオプション：references/command-matrix.md
  • 安全な操作手順：references/safe-workflows.md

コメント

Markdown 対応