calibre-mcp

MCPサーバーは、AIアシスタント(Claude Code、 Claude Desktop、Cursorなど)にローカルのCalibre 電子書籍ライブラリへの読み書きアクセスを提供します。

ライブラリの検索、最近追加された書籍の閲覧、重複自動検出付きの新しい電子書籍のインポート、 そして「ドロップフォルダ」の受信ボックスの管理まで、すべてチャットから行えます。

• 通常のセットアップでは設定不要: calibredb実行ファイルと、Calibre GUIが使用中の ライブラリは、macOS、Windows、Linuxで自動的に検出されます。

• ロケール非依存: すべての読み取りはcalibredb --for-machine(JSON)を 通して行われるため、結果がCalibreインターフェースの言語に影響されることはありません。

• デフォルトで安全: 重複検出はCalibre自体に依存しています。タイトル+著者が すでにライブラリにある書籍はスキップされ、2回インポートされることはありません。

ツール

Related MCP server: Calibre MCP Server

要件

• Calibre(calibredbを同梱する任意のバージョン。9.xでテスト済み)

• Python ≥ 3.10

インストール

pipx(推奨)

pipx install calibre-mcp

uv

uv tool install calibre-mcp

pip

pip install calibre-mcp

ソースから

git clone https://github.com/ZehuiTIAN/calibre-mcp.git
cd calibre-mcp
pip install -e ".[dev]"     # dev extras add pytest + ruff

設定

通常のセットアップではすべて任意です。各値は環境変数で固定できます。

Claude Codeへの登録

claude mcp add calibre-mcp -- calibre-mcp

または~/.claude.json → mcpServers(ユーザースコープ)に追加:

"calibre_mcp": {
  "type": "stdio",
  "command": "calibre-mcp",
  "args": [],
  "env": {
    "CALIBRE_LIBRARY_PATH": "/path/to/your/library",
    "CALIBRE_INBOX_DIR": "/path/to/your/inbox"
  }
}

Claude Desktop / Cursorへの登録

同じJSONブロックを、claude_desktop_config.json(Claude Desktop)またはCursorのMCP設定の MCPサーバーセクションに追加します。

受信ボックスのワークフロー

ドロップフォルダは、手動でダウンロードした書籍に対する「探す → ドロップ → アーカイブ」の 快適なループを実現します:

1. CALIBRE_INBOX_DIRをフォルダ(例:~/Downloads/Calibre-Inbox)に設定します。

2. 電子書籍をそのフォルダにダウンロードします。

3. アシスタントにimport_inboxの実行を依頼します。

すべてのファイルがライブラリに追加されます。正常に追加されたファイルと重複は imported/YYYY-MM/に、失敗したファイルはfailed/に整理されます。受信ボックス 自体はクリーンなまま保たれ、何も上書きされることはありません(名前の衝突には -1、-2、...のサフィックスが付きます)。

対応拡張子:.epub .pdf .mobi .azw .azw3 .djvu .cbz .cbr .fb2 .txt .md .docx .rtf .lit .prc .pdb .chm .htmlz。

注意事項

• データベースロック: Calibre GUIがライブラリを開いている間、書き込み 操作(add_books、import_inbox)はデータベースロックエラーで失敗する可能性があります。 読み取り専用ツールは引き続き動作します。インポート前にCalibreを閉じる(または別の ライブラリに切り替える)必要があります。

• 大規模なライブラリ: add_books/import_inboxは各追加の前後で書籍IDの完全な スナップショットを取得します。実際には高速ですが、インポートごとにO(書籍数)の コストがかかります。

• このツールはあなたのライブラリを整理するだけです。検索やダウンロード機能は 含まれていません。保持する権利のあるコンテンツに対して使用してください。

開発

pip install -e ".[dev]"
ruff check .
pytest -m "not integration"      # unit tests, run anywhere
pytest                           # + integration tests (need local calibre)

統合テストは/tmp配下に使い捨てのライブラリを作成し、実際のライブラリに 一切触れません。

ライセンス

MIT — LICENSEを参照。

中国語の概要

ローカルのCalibreライブラリをClaude/CursorなどのAIアシスタントに接続するMCPサーバー: 5つのツール(library_info / search_books / list_books / add_books / import_inbox)。 calibredbとライブラリの場所を自動検出し、全プラットフォーム(Windows/macOS/Linux)で そのまま使えます。

pipx install calibre-mcp
claude mcp add calibre-mcp -- calibre-mcp

インポート時に自動で重複チェックを行います(タイトル+著者が同じ書籍は重複インポート されません)。CALIBRE_INBOX_DIRの受信ボックスディレクトリと組み合わせて、 ダウンロードした書籍をその中に放り込み、「受信ボックスをインポート」と一言言うだけで アーカイブされ、処理済みのファイルは自動的にimported/またはfailed/に分類されます。

注意:Calibreデスクトップアプリが同じライブラリを開いている場合、書き込み操作は データベースロックで失敗する可能性があります。インポート前にCalibreを閉じてください。