calibreweb-mcp

読み取り専用の Model Context Protocol サーバーで、Calibre-Web（および Calibre-Web Automated）向けのものです。Calibre-Web はセルフホスト型の電子書籍ライブラリ Web UI です。

Calibre-Web には REST API はありません。唯一安定した機械可読インターフェースは、電子書籍リーダーアプリ向けの OPDS カタログフィードです。このサーバーはそのフィードを扱います：Atom XML で HTTP Basic 認証を受け付け、構造化された書籍データを出力します。ライブラリを検索し、キュレーションされたビューや棚をブラウズし、フォーマットごとのダウンロードリンクをたどり、カバー画像をそのまま会話に取り込めます。書き込みは一切行いません。すべてのツールは OPDS ルートへの GET リクエストです。

📖 完全なドキュメント: calibreweb-mcp.ni-c.de

必要条件

• Node.js 22 以上

• Calibre-Web インスタンス（現在の linuxserver/calibre-web イメージに対して開発済み。Calibre-Web Automated も同様に動作します）

• サーバー用の Calibre-Web ユーザー。OPDS フィードは通常の Web ログインで認証します。管理者アカウントではなく、表示とダウンロードの権限のみを持つ専用アカウントを使用してください。インスタンスが匿名ブラウジングを許可している場合、サーバーは認証情報なしでも実行できます。

Related MCP server: access-calibre

設定

¹ 匿名ブラウジングを許可するインスタンスの場合は、両方を未設定のままにします。片方だけ設定すると設定エラーになります。

Claude Code

claude mcp add calibreweb \
  -e CALIBRE_WEB_URL=https://books.example.com \
  -e CALIBRE_WEB_USERNAME=reader \
  -e CALIBRE_WEB_PASSWORD=... \
  -- npx calibreweb-mcp

Claude Desktop

{
  "mcpServers": {
    "calibreweb": {
      "command": "npx",
      "args": ["calibreweb-mcp"],
      "env": {
        "CALIBRE_WEB_URL": "https://books.example.com",
        "CALIBRE_WEB_USERNAME": "reader",
        "CALIBRE_WEB_PASSWORD": "..."
      }
    }
  }
}

Codex

[mcp_servers.calibreweb]
command = "npx"
args = ["calibreweb-mcp"]
env = { CALIBRE_WEB_URL = "https://books.example.com", CALIBRE_WEB_USERNAME = "reader", CALIBRE_WEB_PASSWORD = "..." }

ツール

すべてのツールは読み取り専用です（readOnlyHint: true）。

書籍エントリには、著者、タグ、シリーズ（インデックス付き）、評価、制限付きの要約、表紙 URL、フォーマットごとのダウンロード URL が含まれます。モデル自体が EPUB をダウンロードする理由はないため、人間が開ける準備済みのリンクです。

ページネーション

フィードはインスタンスの 1 ページあたりの書籍数 設定（デフォルト 60）でページネーションされます。ページサイズはクライアント側で制御できません。すべての一覧で、さらにページが存在する場合に pagination.nextOffset が返されます。次の呼び出しで offset として渡します。discover ビューはランダム選択であり、ページネーションされません。

意図的に範囲外

• 書き込みなし。 OPDS フィードには書き込みがなく、このサーバーも追加しません。

• ファイルダウンロードなし。 ツールはダウンロード URL を返しますが、電子書籍のペイロードは返しません。

• ファセットブラウジングなし（著者/シリーズ/タグ/出版社/言語/フォーマットを個別のインデックスフィードとして）。search_books でそれらの検索をカバーします。ルートは存在し、実際のユースケースがあればツールを追加できます。

安全性

• サーバーは設計上読み取り専用です。GET リクエストのみで、状態は一切持ちません。

• 書籍メタデータは信頼できないサードパーティデータです。すべての結果にその旨が明記され、制御文字は削除され、XML エンティティ処理は無効化されています（DOCTYPE またはエンティティを宣言するドキュメントは完全に拒否されます）。

• レスポンスは解析前に制限され（フィードは 8 MB、表紙は 1 MB）、さらにモデルに到達する前に制限されます（書籍ごと、レスポンスごとの予算）。

• フィードの href は、設定されたオリジンに対して http(s) で解決される場合のみ通過します。悪意のあるフィードが javascript:、file:、またはクロスオリジン URL を結果に埋め込むことはできません。

• リダイレクトは拒否されるため、Basic 認証情報が別のホストに再生されることはありません。表紙は、実際の画像コンテンツタイプの場合のみ通過します。

• パスワードは起動時にプロセス環境から消去され、URL はログや結果に表示される前に認証情報が編集されます。

コンテナ

docker run -i --rm \
  -e CALIBRE_WEB_URL=https://books.example.com \
  -e CALIBRE_WEB_USERNAME=reader \
  -e CALIBRE_WEB_PASSWORD=... \
  ghcr.io/ni-c/calibreweb-mcp

開発

npm install
npm test            # unit tests against a stubbed OPDS feed, no instance needed
npm run lint
npm run build

CONTRIBUTING.md を参照してください。

リリース

1. CHANGELOG.md を更新し、package.json（+ ロックファイル）のバージョンを上げます。

2. npm run lint && npm run test:coverage && npm run build

3. リリースにタグを付けます：git tag -s vX.Y.Z -m "vX.Y.Z" && git push origin vX.Y.Z

ライセンス

MIT