{"report":"{\"v\":1,\"package\":\"calibre-mcp\",\"version\":\"0.13.0\",\"ranAt\":\"2026-11-16T11:44:41.642Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-kOb20kHDXy25TOtO2ABlIJ81RJDr1n3fTD3ndN0F0EKNOG/VUXLpJe1NyDHn9iXgJZ2lkdkDIjtGRsKemDxk2g==\",\"deps\":98,\"scripts\":[\"onnxruntime-node\",\"protobufjs\"],\"bins\":[\"calibre-mcp\"],\"license\":\"MIT\",\"engines\":\"node >=22.16\",\"repository\":\"git+https://github.com/caelum29/calibre-mcp.git\",\"bin\":\"calibre-mcp\"},\"start\":{\"ok\":true,\"ms\":266,\"serverName\":\"calibre-mcp\",\"serverVersion\":\"0.13.0\",\"protocol\":\"2025-06-18\",\"stderr\":\"l\\\":\\\"error\\\",\\\"msg\\\":\\\"content-server request failed\\\",\\\"pid\\\":61,\\\"client\\\":\\\"bragproof\\\",\\\"tool\\\":\\\"calibre_list_categories\\\",\\\"call\\\":\\\"7342ac69\\\",\\\"meta\\\":{\\\"url\\\":\\\"http://localhost:8080/ajax/library-info\\\",\\\"aborted\\\":false,\\\"cause\\\":\\\"fetch failed\\\"}}\\n[calibre-mcp] {\\\"ts\\\":\\\"2026-11-16T11:44:56.876Z\\\",\\\"lvl\\\":\\\"error\\\",\\\"msg\\\":\\\"tool call\\\",\\\"pid\\\":61,\\\"client\\\":\\\"bragproof\\\",\\\"tool\\\":\\\"calibre_list_categories\\\",\\\"call\\\":\\\"7342ac69\\\",\\\"meta\\\":{\\\"durationMs\\\":1,\\\"rpcId\\\":6,\\\"isError\\\":true,\\\"errorCode\\\":\\\"calibre_unreachable\\\",\\\"hint\\\":\\\"start it in Calibre (Connect/share → Start Content server) or set CALIBRE_MCP_SERVER_URL\\\",\\\"error\\\":\\\"Error: Cannot reach Calibre Content Server\\\\nCode: calibre_unreachable\\\\nNext: start it in Calibre (Connect/share → Start Content server) or set CALIBRE_MCP_SERVER_URL\\\",\\\"args\\\":{\\\"limit\\\":100}}}\\n[calibre-mcp] {\\\"ts\\\":\\\"2026-11-16T11:44:56.878Z\\\",\\\"lvl\\\":\\\"error\\\",\\\"msg\\\":\\\"content-server request failed\\\",\\\"pid\\\":61,\\\"client\\\":\\\"bragproof\\\",\\\"tool\\\":\\\"calibre_find_duplicates\\\",\\\"call\\\":\\\"743cd28a\\\",\\\"meta\\\":{\\\"url\\\":\\\"http://localhost:8080/ajax/library-info\\\",\\\"aborted\\\":false,\\\"cause\\\":\\\"fetch failed\\\"}}\\n[calibre-mcp] {\\\"ts\\\":\\\"2026-11-16T11:44:56.878Z\\\",\\\"lvl\\\":\\\"error\\\",\\\"msg\\\":\\\"tool call\\\",\\\"pid\\\":61,\\\"client\\\":\\\"bragproof\\\",\\\"tool\\\":\\\"calibre_find_duplicates\\\",\\\"call\\\":\\\"743cd28a\\\",\\\"meta\\\":{\\\"durationMs\\\":1,\\\"rpcId\\\":7,\\\"isError\\\":true,\\\"errorCode\\\":\\\"calibre_unreachable\\\",\\\"hint\\\":\\\"start it in Calibre (Connect/share → Start Content server) or set CALIBRE_MCP_SERVER_URL\\\",\\\"error\\\":\\\"Error: Cannot reach Calibre Content Server\\\\nCode: calibre_unreachable\\\\nNext: start it in Calibre (Connect/share → Start Content server) or set CALIBRE_MCP_SERVER_URL\\\",\\\"args\\\":{\\\"mode\\\":\\\"identical\\\",\\\"limit\\\":50}}}\\n\"},\"tools\":[{\"name\":\"calibre_list_libraries\",\"description\":\"List the Calibre libraries available on the Content Server (ID and display name) and which one is the default. Other tools take either as `library`, or use the default when it is omitted.\",\"params\":[]},{\"name\":\"calibre_search\",\"description\":\"Find books by `query`: exact title, author, ISBN, tag, or Calibre query syntax (mode=meta), or full text (mode=fts). mode=fts words match independently and stemmed (events matches event); wrap a phrase in double quotes for an exact match (\\\"event sourcing\\\"); supports AND/OR/NOT between terms (uppercase, e.g. a NOT b). scope=book returns short keyword snippets from inside one book; first hits often land in TOC/front matter — for definitional or topic questions within a book prefer calibre_semantic_search scope=book (ranked passages with char offsets). Use calibre_semantic_search for meaning/topic queries. For \\\"how many\\\" questions use countOnly=true (returns only the count). filter accepts a bundle name to scope the search (list bundles via calibre_manage_bundles). Calibre 9.18+: mode=annotations searches highlights, their notes and bookmark titles (filter applies; scope=book + bookId searches one book, query \\\"*\\\" lists all its annotations); mode=notes searches notes attached to authors, series, tags, publisher (filters do not apply), and query \\\"authors:Name\\\" (or series:/tags:/publisher:/#custom:, item may be quoted) shows the whole note of that item.\",\"params\":[\"query\",\"mode\",\"scope\",\"bookId\",\"library\",\"sort\",\"sortOrder\",\"limit\",\"cursor\",\"countOnly\",\"filter\",\"include_excluded\"]},{\"name\":\"calibre_get_book\",\"description\":\"Get full metadata (authors, ISBN, formats, comments, cover) for one book by its id or uuid (id and bookId are interchangeable — pass the bookId from a search result). Set include_cover=true only when the cover image itself must be inspected.\",\"params\":[\"id\",\"bookId\",\"library\",\"include_cover\"]},{\"name\":\"calibre_get_content\",\"description\":\"Extract a book's text as a capped, fenced excerpt; pass the returned nextCursor token verbatim to walk the whole book, or jump to a char position with offset (e.g. a search passage's charStart). Set structure=true for a chapter map with per-chapter cursors. To find text inside a book, use calibre_search scope=book.\",\"params\":[\"id\",\"bookId\",\"format\",\"maxChars\",\"sentenceAware\",\"structure\",\"cursor\",\"offset\",\"library\"]},{\"name\":\"calibre_get_figures\",\"description\":\"List a book's figures — images the text references, identified by caption (Figure 1-2 / Рис. 3.1) — with location (PDF page p.N / EPUB spine section §N) + caption per figure, then fetch chosen ones as images via indexes (≤3 per call). Captions let you pick figures before spending image tokens. In MCP Apps hosts the fetched figures also render for the user in an in-chat viewer, so you can point at them by figure number — but describe only what the pixels you received actually show.\",\"params\":[\"id\",\"bookId\",\"format\",\"indexes\",\"detail\",\"include_uncaptioned\",\"library\"]},{\"name\":\"calibre_list_categories\",\"description\":\"Browse library categories (Authors, Tags, Series, Languages, Publisher). No field → list the categories; with a field → its values + counts, filterable via a valueFilter regex (case-insensitive by default; a leading inline flag like `(?i)` is accepted).\",\"params\":[\"field\",\"valueFilter\",\"library\",\"limit\",\"cursor\"]},{\"name\":\"calibre_semantic_search\",\"description\":\"Meaning-based search for `query` over the local index. scope=library ranks books; scope=book (needs bookId) ranks passages within one book. target=figures searches figure captions instead of text — use when the user asks for a diagram/chart/schema; hits point at calibre_get_figures for the pixels. mode=hybrid (default) fuses semantic + keyword matches; mode=vector is semantic-only; mode=keyword is exact keyword/FTS (no model at query time). All modes need an index built by calibre_build_index. filter accepts a bundle name to scope library searches (list bundles via calibre_manage_bundles). Model inference is serialized: prefer one call at a time — parallel calls queue, and past a few the extras skip the rerank.\",\"params\":[\"query\",\"scope\",\"target\",\"mode\",\"bookId\",\"topK\",\"library\",\"filter\",\"include_excluded\"]},{\"name\":\"calibre_build_index\",\"description\":\"Build the semantic index for specific books (select them with bookId, ids, or query; at least one is required; to index everything, pass a query that matches every book). A query selects ALL matching books (no 100-book cap); a call still working after ~45 s returns a \\\"still running\\\" status (not an error) while the build keeps committing in the background — re-run the same call to get its result; only one build runs per library at a time, and up-to-date books are skipped. Extracts, chunks, and embeds each book. Set keywordOnly=true (or when the embedding model is absent, it happens automatically) to build a keyword-only index that powers mode:\\\"keyword\\\" search with zero ML dependencies. Re-run after adding books; use force to re-index unchanged ones. Set enableFts=true to also turn on the Calibre full-text index for the library (needs writes enabled on this server; with writes off the semantic build still runs and the fts.status result field is write_disabled; already-enabled is a no-op; Calibre indexes in the background and the call does not wait). Set prune=true to also drop index entries for books that no longer exist in the library (removals/merges leave searchable orphans behind).\",\"params\":[\"bookId\",\"ids\",\"query\",\"library\",\"force\",\"enableFts\",\"keywordOnly\",\"prune\"]},{\"name\":\"calibre_find_duplicates\",\"description\":\"Find probable duplicate books. mode=identical (exact title+authors) or similar (fuzzy) group the library (or ids/query/filter subset — filter takes a bundle name) with a merge-safety score; mode=compare diffs 2+ ids field-by-field. Read-only — never merges.\",\"params\":[\"mode\",\"ids\",\"query\",\"filter\",\"library\",\"limit\",\"cursor\"]},{\"name\":\"calibre_quality_report\",\"description\":\"Scan books for metadata problems: missing fields, raw-filename titles, invalid ISBNs, author-sort mismatches, series gaps. Defaults to the whole library; narrow with ids/query/filter (a bundle name) or specific checks. Read-only.\",\"params\":[\"checks\",\"ids\",\"query\",\"filter\",\"library\",\"limit\",\"cursor\"]},{\"name\":\"calibre_recover_metadata\",\"description\":\"Propose real metadata for a book with a missing/raw-filename title via online provider lookup (ISBN from its identifiers or text, else title/author) on Open Library and Google Books. Preview only — returns a changes object for calibre_update_book (needs writes enabled); never writes.\",\"params\":[\"id\",\"bookId\",\"sources\",\"library\"]},{\"name\":\"calibre_extract_isbn\",\"description\":\"Offline scan of a book's own text for a checksum-valid ISBN → sets identifiers:isbn (no network; for online lookup use calibre_recover_metadata). Preview-first: apply=false reports only, merges into existing identifiers. Previews work without writes; applying needs CALIBRE_MCP_ENABLE_WRITE.\",\"params\":[\"id\",\"bookId\",\"apply\",\"library\"]},{\"name\":\"calibre_bulk_update\",\"description\":\"Apply the same metadata changes (tags, series, publisher, etc.) to a set of books selected by ids, a search query, or filter (a bundle name). Preview-first: returns the per-book diff without writing unless preview is set false. A book set is required (never all books). A list in changes replaces the whole list; to add or remove tags while keeping the rest, use tags_add / tags_remove (merged per book, case-insensitive, not together with changes.tags). changes.identifiers merges per book by scheme (listed schemes set, others kept, null removes one). Previews work without writes; applying needs CALIBRE_MCP_ENABLE_WRITE.\",\"params\":[\"changes\",\"tags_add\",\"tags_remove\",\"ids\",\"query\",\"filter\",\"library\",\"preview\"]},{\"name\":\"calibre_remove_book\",\"description\":\"Remove books (ids) from the library. Removed books go to Calibre's Trash and can be restored from the Calibre GUI, so this is recoverable. Two-step: the first call is a dry-run listing what would be removed; re-run with confirm=true to proceed. Previews work without writes; applying needs CALIBRE_MCP_ENABLE_WRITE.\",\"params\":[\"ids\",\"library\",\"confirm\"]},{\"name\":\"calibre_merge_books\",\"description\":\"Merge duplicate book records: moves formats from the `sourceIds` books into `targetId` (the target's copy wins conflicts), merges metadata per Calibre's rules, then trashes the sources. mode=safe keeps sources; mode=formatsOnly moves formats only. Dry-run unless confirm=true. Previews work without writes; applying needs CALIBRE_MCP_ENABLE_WRITE.\",\"params\":[\"targetId\",\"sourceIds\",\"mode\",\"confirm\",\"library\"]},{\"name\":\"calibre_manage_bundles\",\"description\":\"Manage Bundles via `action` (list | create | update | delete) — named topical filters backed by Calibre saved searches (e.g. a 'rust' bundle scoping searches to Rust books). A name starting with '-' is an exclusion marker. Also lists virtual libraries, which are read-only here. Preview-first: create/update/delete preview until confirm=true. Previews work without writes; applying needs CALIBRE_MCP_ENABLE_WRITE.\",\"params\":[\"action\",\"name\",\"expression\",\"library\",\"confirm\"]},{\"name\":\"calibre_board_data\",\"description\":\"Internal endpoint for the in-chat cover-board widget. Returns the cached payload of a recent search. Do not call as the model — search results already contain everything this returns.\",\"params\":[\"tool\",\"query\",\"library\",\"filter\"]},{\"name\":\"calibre_open_book\",\"description\":\"Internal endpoint for the in-chat widgets' Open button. Launches a book in the local Calibre viewer via the calibre:// scheme. Do not call as the model — use calibre_get_book to show a book instead.\",\"params\":[\"id\",\"format\",\"library\"]},{\"name\":\"calibre_ping\",\"description\":\"Health check: confirms the server reaches Calibre via calibredb and whether Calibre accepts writes; reports semantic-search status, per-library index coverage, version, write gate, busy libraries, recent errors and the log file path.\",\"params\":[]}],\"toolsHash\":\"2b2def4dbbb8f19cfe26b91474109e8315ed2c5ea3fd59b4d3de64c8644cb6fa\",\"wrote\":[\"/tmp/.local/share/calibre-mcp/index/logs/README.md\",\"/tmp/.local/share/calibre-mcp/index/logs/calibre-mcp-2026-11-16.jsonl\"],\"callsAt\":\"2026-11-16T11:44:55.863Z\",\"calls\":[{\"tool\":\"calibre_list_libraries\",\"ok\":false,\"ms\":7,\"bytes\":0,\"error\":\"tool reported an error: Error: Cannot reach Calibre Content Server at http://localhost:8080 — is the Calibre GUI / Content Server running?\\nCode: calibre_unreachable\\nNext: start it in Calibre (Connect/share → Start Content se\"},{\"tool\":\"calibre_get_content\",\"ok\":false,\"ms\":2,\"bytes\":0,\"error\":\"tool reported an error: Error: Provide id (the book's db id or uuid).\\nCode: invalid_input\"},{\"tool\":\"calibre_get_figures\",\"ok\":false,\"ms\":1,\"bytes\":0,\"error\":\"tool reported an error: Error: Provide id (the book's db id or uuid).\\nCode: invalid_input\"},{\"tool\":\"calibre_list_categories\",\"ok\":false,\"ms\":2,\"bytes\":0,\"error\":\"tool reported an error: Error: Cannot reach Calibre Content Server\\nCode: calibre_unreachable\\nNext: start it in Calibre (Connect/share → Start Content server) or set CALIBRE_MCP_SERVER_URL\"},{\"tool\":\"calibre_find_duplicates\",\"ok\":false,\"ms\":3,\"bytes\":0,\"error\":\"tool reported an error: Error: Cannot reach Calibre Content Server\\nCode: calibre_unreachable\\nNext: start it in Calibre (Connect/share → Start Content server) or set CALIBRE_MCP_SERVER_URL\"}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OjI4YTQ2MDdmN2MxOTE4ZTkzN2VlNTU4MGY5ZTQ4MGFlZTUzZTAwNGI0NmRkMGNhMmQyYmU0NWM2YjAyNmRiZTQiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTM2MyIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyOTgwMiwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjk1MDIsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiOGYxNzBlMzMtNTNlMi00YzExLTllOGMtZGNhNjM5NTEzOTM1IiwibmJmIjoxNzk0ODI5MjAyLCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.MXQagJ5s2dA3IKD5QYNXroC5iZ11K8MmQgUaJRhK-PsU0AJV9co2zizfy6U47MkBLkt4durtVmdz2mcUPrxXV6i2K8RPY0b9-zZOTcVEqzJbJW9vREMlOwCn-DuxBXEhpkme1b8mqOkVjxIqW2SsWO7lIMjBDLiMW8It36I-JaksRZu9Klcqhr-lCRXLRHA35gi7shcMyeNC7XGaLFu7FDKvQVCRmjHfDFF1nzs7tFfg-AGEIN9RcXvQEyoT--0XuEDxUJmEHXLges2BGv6q5FrtZR1mfmueJ5cOEi9kHju4zEZbh1rNT_UTbvtzr1MY_DOG8IP9lQjg2UnD-tsheA"}