이 MCP 서버는 AI 에이전트와 Calibre ebook 라이브러리 사이의 간격을 브릿지합니다. 디지털 라이브러리를 검색하고 관리하고, 디지털 라이브러리를 읽을 수 있도록 동적인 지식 베이스로 컬렉션과 상호 작용할 수 있습니다. 다른 MCP 서버와는 달리, 라이브러리의 권한이 설정된 경우 라이브러리 메타데이터 및 내용을 업데이트할 수 있습니다.

키 기능

• ** 고급 검색:** 책 metadata를 사용하여 Query 라이브러리 또는 전체 텍스트 콘텐츠 검색 수행.

• 메타데이터 관리: 보기 및 업데이트 메타데이터 (제목, 저자, 태그, 등급 등) 어떤 책에 대 한.

• Library 유지 보수: 수집에 새로운 제목을 추가하거나 기존의 것을 제거합니다.

• **Format 변환 : ** 레버리지 Calibre의 강력한 변환 엔진은 전자 책 형식 (예를 들어, PDF에서 EPUB) 사이의 전환합니다.

• ** 직접 읽기 :** 분석, 요약, Q&A에 대한 에이전트의 컨텍스트 창에 직접 책의 텍스트 내용을 검색하고 읽으십시오.

• Granular Permissions: 읽기 전용 모드 및 필드 레벨 쓰기 제한을 포함하여 라이브러리 당 엄격한 액세스 제어를 정의합니다.

---

필수품

• 캘리브: 호스트 시스템에 설치해야합니다.

Calibre MCP Server

This MCP server bridges the gap between AI agents and your Calibre ebook libraries. It enables agents to interact with your collection as a dynamic knowledge base, allowing them to search, manage, and read your digital libraries. Unlike other MCP servers it can also allow an AI agent to update library metadata and contents if a library’s permissions are set to allow it.

Key Features

• Advanced Search: Query libraries using book metadata or perform full-text content searches.

• Metadata Management: View and update metadata (titles, authors, tags, ratings, etc.) for any book.

• Library Maintenance: Add new titles to your collection or remove existing ones.

• Format Conversion: Leverage Calibre’s powerful conversion engine to switch between ebook formats (e.g., PDF to EPUB) on the fly.

• Direct Reading: Search and read the text content of a book directly into the agent’s context window for analysis, summarization, or Q&A.

• Granular Permissions: Define strict access controls per library, including read-only modes and field-level write restrictions.

---

Prerequisites

• Calibre: Must be installed on the host system. This server utilizes calibre-debug to execute worker processes.

• Concurrency Note: Calibre does not support concurrent access to a single library. Do not point an agent to a library currently being used by the Calibre desktop application or other calibre processes to avoid database corruption. Setting a worker_timeout can reduce the risk of this happening accidentally, but don’t rely on that to protect your libraries. Be aware of what you’re doing.

---

Configuration

The server is configured via a JSON file. Since JSON does not support comments, use the structure below as a template.

Example Configuration (config.json)

JSON

{
    "libraries": {
        "default": {
            "path": "d:/ebooks/main_library",
            "description": "The primary research library containing technical manuals.",
            "default": true,
            "permissions": {
                "read": ["title", "authors", "tags", "rating", "comments"],
                "write": ["tags", "rating", "comments"],
                "delete": false,
                "convert": true
            },
            "import": {
                "allowed_paths": ["d:/downloads/ebook_imports"],
                "allow_delete_source": false
            },
            "export": {
                "allowed_paths": ["d:/ebook_exports"s],
                "allow_overwrite_destination": false
            },
            "worker_timeout": 300
        }
    },
    "port": 8000,
    "enable_worker_logging": false,
    "expose_resources_via_tools": true,
    "log_level": "warning"
}

Configuration Schema Reference

Each library is identified by a unique text key and can have its own separate configuration values: