calibremcp

# calibre-mcp

> FastMCP 3.1+ MCP server for Calibre libraries: portmanteau tools, Calibre FTS, LanceDB metadata + chunk RAG, prompts, bundled skill, optional webapp (**10720** / **10721**).

**Full corpus (tools, env, run, troubleshooting):** [llms-full.txt](./llms-full.txt)

Fleet bar: **uv** + **justfile** + **llms.txt** / **llms-full.txt** + **glama.json** — [mcp-central-docs PACKAGING_STANDARDS §5](https://github.com/sandraschi/mcp-central-docs/blob/master/standards/PACKAGING_STANDARDS.md)

## Quick start

1. **Clone** the repo, then **`uv sync`** (see README; do not run `uv sync` without checkout).
2. **stdio MCP:** `uv run python -m calibre_mcp` with `CALIBRE_LIBRARY_PATH` or switch library via tool.
3. **Webapp:** `webapp/start.ps1` — backend **10720**, frontend **10721**.

## Docs (curated)

| Doc | Purpose |
|-----|---------|
| [README.md](README.md) | Install, features, examples |
| [docs/README.md](docs/README.md) | Documentation hub |
| [docs/DOCUMENTATION_INDEX.md](docs/DOCUMENTATION_INDEX.md) | Full map + archival paths |
| [docs/TAURI.md](docs/TAURI.md) | Tauri installer (maintainers) |
| [INSTALL.md](INSTALL.md) | Desktop + dev install |
| [docs/AGENTIC_AND_RAG.md](docs/AGENTIC_AND_RAG.md) | FTS vs metadata RAG vs chunk RAG; LanceDB paths |
| [docs/COOKBOOK.md](docs/COOKBOOK.md) | Lane picker, chains |
| [docs/CALIBRE_DEBUG_EXPORT_AND_RAG_PLAN.md](docs/CALIBRE_DEBUG_EXPORT_AND_RAG_PLAN.md) | `calibre-debug` JSON export, env caps |
| [docs/PROMPTS.md](docs/PROMPTS.md) | MCP prompt names |
| [CHANGELOG.md](CHANGELOG.md) | Release notes |
| [docs/mcp-technical/MCP_APPS_PREFAB.md](docs/mcp-technical/MCP_APPS_PREFAB.md) | Optional Prefab cards (`show_book_prefab_card`, `show_libraries_prefab_card`; `uv sync --extra apps`) |

## Configuration

- [pyproject.toml](pyproject.toml) — dependencies, `uv` project
- [glama.json](glama.json) — registry discovery
- [manifest.json](manifest.json) — MCPB manifest (see `mcpb/`)

## Scripts

- [scripts/export_metadata_for_rag.py](scripts/export_metadata_for_rag.py) — run with **`calibre-debug -e`** for Calibre `new_api` JSON export