calibre-mcp

Calibre電子書籍ライブラリを検索、閲覧、管理するためのModel Context Protocol (MCP) サーバーです。TypeScriptでBun向けに完全に書き直されており、超高速なパフォーマンス、CalibreのCLIツールとの深い統合、自動化されたコンテンツ抽出を提供します。

🚀 機能

• 爆速メタデータ検索: SQLiteを介してCalibreの metadata.db を直接クエリし、ほぼ瞬時に結果を取得します。

• 全文コンテンツ検索: Calibreのインデックス付き全文検索エンジンを活用し、ライブラリ全体から特定のフレーズを検索します。

• 動的コンテンツ抽出: EPUB、PDF、その他の形式をオンザフライで自動的にテキストに変換します。.txtへの手動エクスポートは不要です。

• 包括的なライブラリ管理: データベースのメタデータ更新、内部ファイルのメタデータ変更、書籍の洗練（polish）、形式変換を行います。

• スマートな結果配布: 検索結果は、多様な一致を提供するために、異なる書籍間でインテリジェントにバランス調整されます。

• カスタムURLスキーム: 書籍の場所や行範囲を正確に参照するために epub:// URLを使用します。

Related MCP server: Calibre RAG MCP Server

📋 前提条件

• Calibre が /Applications/calibre.app (macOS) にインストールされていること。

• Bun ランタイムがインストールされていること。

• Calibreライブラリがあること。

⚙️ 設定

サーバーは以下の環境変数を使用します：

• CALIBRE_LIBRARY_PATH: Calibreライブラリへのパス (metadata.db が存在する場所)。デフォルトは /Volumes/Xarismata/eBooks/CalibreNuevo です。

🛠 インストール

1. このリポジトリをクローンします：

git clone https://github.com/2b3pro/calibre-mcp.git
cd calibre-mcp

2. 依存関係をインストールします：

bun install

⌨️ 使用方法

MCP Inspectorを使用する場合

対話型環境でサーバーをテストします：

npx @modelcontextprotocol/inspector bun src/index.ts

Claude Desktopを使用する場合

claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "calibre": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/calibre-mcp/src/index.ts"]
    }
  }
}

🧰 利用可能なツール

ツールの詳細と例

search_library

自然言語を使用してコンテンツを検索するか、特定のフィールドを使用してメタデータを検索します。

• クエリの例：

  • "machine learning" (全文検索)

  • author:Asimov title:Foundation (メタデータ検索)

  • tag:science-fiction rating:>4 (高度なフィルタリング)

read_content

epub:// スキームを使用します。

• 形式: epub://[author]/[title]@[book_id]#[start_line]:[end_line]

• 例: epub://Isaac%20Asimov/Foundation@123#500:600 は500行目から600行目までを取得します。

polish_book

自動変換されたファイルや古いファイルのクリーンアップに最適です。

• オプション: smartenPunctuation, compressImages, upgradeBook, removeUnusedCss。

convert_ebook

形式を変換し、ライブラリレコードを自動的に更新します。

• 例: book_id: 45, output_format: "azw3", options: ["--enable-heuristics"]

deep_search_book

特定の書籍内を直接検索します (CalibreのFTSがまだインデックスを作成していない場合に便利です)。

• 例: book_id: 123, query: "quantum entanglement", context_lines: 3

⚖️ ライセンス

Apache License 2.0 - 詳細は LICENSE ファイルを参照してください。