CalibreMCP
📖 Installation Guide — download the
.exefrom Releases, double-click, done
FastMCP 3.2 MCP server for Calibre e-book library management — AI-assisted search, RAG, and agentic workflows for Sandra's 1000+ book library.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
📖 Installation Guide — download the
.exefrom Releases, double-click, done
FastMCP 3.2 MCP server for Calibre e-book library management — AI-assisted search, RAG, and agentic workflows for Sandra's 1000+ book library.
Calibre library automation via FastMCP — metadata, shelves, RAG, ai workflows. Plus webapp and tauri rust winapp
Download Calibre MCP_*_x64-setup.exe from Releases → double-click → launch Calibre MCP. Install guide.
Claude Desktop one-liner (MCPB bundle): download calibre-mcp.mcpb from Releases and install via Settings → MCP Servers → Install from file.
Developers from source:
git clone https://github.com/sandraschi/calibremcp
cd calibremcp
just sync
just start-webapp
// claude_desktop_config.json { "mcpServers": { "calibre-mcp": { "command": "uv", "args": ["run", "calibre-mcp"], "env": { "CALIBRE_LIBRARY_PATH": "L:/Multimedia Files/Written Word/Calibre-Bibliothek" } } } } Then ask Claude: "Find unread sci-fi books", "Open a random Banks novel", or "What's my library health?"
calibre-mcp bridges your Calibre e-book library and AI assistants (Claude Desktop, Cursor, etc.) via the Model Context Protocol. It reads Calibre's metadata.db directly, indexes metadata for semantic search (LanceDB RAG), and exposes 33 portmanteau tools for natural-language library management.
┌────────────────────────────────────────────────────────────────────────────────────────┐
│ CLIENT INTERFACES │
│ ┌───────────────────────┐ ┌─────────────────────────┐ ┌──────────────────────────┐ │
│ │ Claude Desktop │ │ Calibre MCP WebApp │ │ Calibre GUI + Plugin │ │
│ │ (MCP stdio / MCPB) │ │ (Next.js 15 @ :10721) │ │ (Qt6 / PyQt5 Plugin) │ │
│ └───────────┬───────────┘ └────────────┬────────────┘ └────────────┬─────────────┘ │
└──────────────┼───────────────────────────┼────────────────────────────┼────────────────┘
│ JSON-RPC (stdio) │ REST / SSE │ Direct SQLite
▼ ▼ ▼
┌───────────────────────────────────────────────────────┐ ┌─────────────────────────────┐
│ CALIBRE-MCP BACKEND (:10720) │ │ CALIBRE CONTENT SERVER │
│ │ │ (e.g. :8099) │
│ ┌─────────────────────────────────────────────────┐ │ │ │
│ │ FastMCP 3.2 Server + Tool Registry (21 tools) │ │ │ - Async Python Engine │
│ │ - Reciprocal Rank Fusion (RRF) Hybrid Search │ │ │ (calibre.srv) │
│ │ - Incremental LanceDB RAG Sync │ │ │ - RapydScript SPA │
│ │ - Portmanteau CRUD & Library Health Engine │ │ │ (index-generated.html) │
│ └─────────────────────────────────────────────────┘ │ │ - HTML5 In-Browser Reader │
│ ┌─────────────────────────────────────────────────┐ │ │ (viewer.js / offline SW) │
│ │ FastAPI REST Layer + Async Background Workers │ │ │ - OPDS Mobile Catalog Feed │
│ └─────────────────────────────────────────────────┘ │ └──────────────┬──────────────┘
└──────────────┬───────────────────────────┬────────────┘ │
│ │ │
▼ ▼ ▼
┌──────────────────────────────┐ ┌──────────────────────────────────────────────────────┐
│ AI / VECTOR LAYER │ │ DATA STORAGE LAYER │
│ - LanceDB (Metadata & FTS) │ │ - metadata.db (Calibre SQLite catalog) │
│ - fastembed (BAAI/bge-small)│ │ - full-text-search.db (Calibre FTS5 token index) │
│ - Ollama / OpenAI Provider │ │ - calibre_mcp_data.db (Sidecar extended metadata) │
└──────────────────────────────┘ └──────────────────────────────────────────────────────┘
In a production Calibre environment, two distinct web applications operate side-by-side:
Calibre Content Server (http://goliath:8099/ or http://localhost:8080/):
calibre.exe --start-in-tray or headless calibre-server.exe). It executes an asynchronous Python HTTP/1.1 daemon (calibre.srv) delivering a compiled Single Page Application bundled inside resources/content-server/index-generated.html (~3.9 MB, transpiled from Python-like AST to ES6 JavaScript using RapydScript).viewer.html/viewer.js with offline reading via ServiceWorkers, highlights, annotations, bookmarks, and font settings), native OPDS feeds for mobile readers (KyBook, Moon+ Reader), and direct format conversion.CalibreMCP WebApp (http://localhost:10721/, backend :10720):
app.main:app) running FastMCP 3.2.start.ps1); run webapp/start-lan.ps1 for LAN / Tailscale access from phone, tablet, or a second PC (no auth — trusted networks only). See Remote Access.Together, Calibre Content Server provides the high-performance reading and distribution engine, while CalibreMCP provides the conversational AI, semantic discovery, and automated library maintenance engine.
# Development install
git clone https://github.com/sandraschi/calibremcp.git
cd calibremcp
uv sync
# Or via MCPB package
npx mcpb install calibre-mcp
start-lan.ps1Austrian efficiency for digital libraries. Built with realistic AI-assisted development timelines.
Calibre library automation via FastMCP — metadata, shelves, RAG, ai workflows. Plus webapp and tauri rust winapp
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Calibremcp 透過 stdio 在本機執行。
上次檢查時間:2026-11-16。 Calibre library automation via FastMCP — metadata, shelves, RAG, ai workflows. Plus webapp and tauri rust winapp