de en es ja ko ru zh

apple-books-mcp

Name: apple-books-mcp
Author: vgnshiyer

by vgnshiyer

Overview Schema Related Servers Score Discussions

Python

Local

Apple Books MCP

Apple Books를 위한 Model Context Protocol (MCP) 서버입니다.

Website PyPI License: Apache 2.0 Buy Me A Coffee

한눈에 보기

읽던 곳부터 계속하기 — Claude가 현재 읽고 있는 챕터와 그 텍스트, 그리고 최근 강조 표시한 내용을 확인합니다.
강조 표시 확장 — 표시한 정확한 앵커가 «...»로 표시된 상태에서 문맥에 맞는 주변 단락 설명을 얻을 수 있습니다.
책 다시 보기 — 강조 표시를 불러와 테마별로 분류하고, 본인의 인용구를 다시 확인합니다.
독서 성찰 — 책 전반에 걸친 패턴, 강조 표시에서 반복되는 아이디어, 실제로 무엇에 끌리는지 파악합니다.

https://github.com/user-attachments/assets/77a5a29b-bfd7-4275-a4af-8d6c51a4527e

그 외에도 많은 기능이 있습니다!

Related MCP server: Co-Reading MCP

사용 가능한 도구

컬렉션

도구	설명	매개변수
list_all_collections	모든 컬렉션 나열	limit?: int
get_collection_books	컬렉션 내 모든 책 가져오기	collection_id: str
describe_collection	컬렉션 세부 정보 가져오기	collection_id: str
search_collections_by_title	제목으로 컬렉션 검색	title: str

도서

도구	설명	매개변수
list_all_books	모든 책 나열	limit?: int
describe_book	특정 책의 세부 정보 가져오기 (메타데이터, 진행률, 주석 수, 설명)	book_id: str
list_annotations	책의 모든 주석 가져오기 (행별 id + 텍스트 + 챕터, 챕터 순)	book_id: int, limit?: int
search_books_by_title	제목으로 책 검색	title: str
get_books_by_genre	장르별로 책 가져오기 (부분 일치)	genre: str, limit?: int

독서 상태

도구	설명	매개변수
get_books_in_progress	현재 읽고 있는 책 가져오기	limit?: int
get_finished_books	다 읽은 책 가져오기	limit?: int
get_unstarted_books	아직 시작하지 않은 책 가져오기	limit?: int
get_recently_read_books	가장 최근에 연 책 가져오기	limit?: int (기본값: 10)

주석

도구	설명	매개변수
list_all_annotations	책별로 그룹화된 모든 주석 탐색 (최신순)	limit?: int
recent_annotations	가장 최근 주석 가져오기 (행별 날짜 + 책 포함)	limit?: int (기본값: 10)
describe_annotation	단일 주석의 전체 세부 정보 가져오기	annotation_id: str
get_annotation_context	강조 표시 주변의 텍스트 창 (포함된 단락), 강조 표시는 `«...»`로 표시	annotation_id: int, chars_before?: int (기본값: 500), chars_after?: int (기본값: 500)
get_highlights_by_color	특정 색상의 강조 표시, 책별로 그룹화	color: str, limit?: int
search_notes	사용자 메모 검색 (강조 표시 + 메모 인라인 표시)	note: str, limit?: int
search_annotations	강조 표시 + 메모 + 주변 텍스트 검색	text: str, limit?: int
get_annotations_by_date_range	날짜 범위 내 주석 (행별 날짜 + 책 포함)	after?: YYYY-MM-DD, before?: YYYY-MM-DD, limit?: int

라이브러리 통계

도구	설명	매개변수
get_library_stats	독서 통계가 포함된 라이브러리 요약 가져오기	없음

도서 콘텐츠

DRM이 없는 EPUB(가져온 책, Project Gutenberg, Standard Ebooks 등)에서만 작동합니다. Apple Books Store에서 구매한 도서는 FairPlay로 보호되며 명확한 오류를 반환합니다. iCloud 전용 도서는 "다운로드되지 않음" 힌트를 반환합니다.

도구	설명	매개변수
list_book_chapters	책의 목차 (챕터 제목, 순서, 중첩)	book_id: int
get_chapter_content	챕터의 일반 텍스트 콘텐츠, 선택적 `offset` + `max_chars` 슬라이싱 포함	book_id: int, chapter_id: str, offset?: int, max_chars?: int
get_current_reading_position	사용자가 마지막으로 읽던 챕터 (Apple Books의 자동 책갈피 CFI 사용)	book_id: int

사용 가능한 리소스

Claude Desktop의 리소스 선택기에서 액세스할 수 있는 연결 가능한 데이터 객체입니다.

리소스	URI	설명
Currently Reading	`apple-books://currently-reading`	현재 읽고 있는 책 — 가장 최근에 연 진행 중인 책으로, 메타데이터, 마지막으로 읽던 챕터와 텍스트 미리보기(DRM이 없는 EPUB의 경우), 최근 주석이 포함됩니다. 대화에 첨부하여 Claude가 현재 읽고 있는 책에 집중하도록 하세요.

사용 가능한 프롬프트

Claude Desktop의 프롬프트 선택기에서 액세스할 수 있는 원클릭 워크플로우입니다.

프롬프트	설명	인수
weekly_digest	지난주에 읽고 강조 표시한 내용 요약	days?: int (기본값: 7)
library_snapshot	전체 독서 생활에 대한 성찰	없음
revisit_book	특정 책의 메모와 강조 표시 다시 보기	book_title: str

설치

uv 사용 (권장)

uvx를 사용하여 apple-books-mcp를 직접 실행할 수 있습니다(설치 없이).

brew install uv  # for macos
uvx apple-books-mcp

pip 사용

pip install apple-books-mcp

설치 후 다음을 사용하여 서버를 실행할 수 있습니다:

python -m apple_books_mcp

Docker 사용

docker run -v ~/Library/Containers/com.apple.iBooksX/Data/Documents:/root/Library/Containers/com.apple.iBooksX/Data/Documents:ro ghcr.io/vgnshiyer/apple-books-mcp:latest

최초 실행 권한 프롬프트 (macOS)

처음 사용할 때 macOS는 uvx(또는 실행 방식에 따라 python / docker)가 "다른 앱의 데이터에 액세스"할 수 있는지 묻습니다. 허용을 클릭하세요. MCP는 macOS가 다른 앱의 샌드박스 데이터로 취급하는 ~/Library/Containers/com.apple.iBooksX/에 있는 Apple Books의 개인 컨테이너를 읽습니다. 액세스는 읽기 전용이며 해당 컨테이너로 범위가 제한됩니다. 어느 쪽이든 서버는 성공적으로 시작되지만, 권한이 없으면 모든 도구가 빈 결과로 돌아옵니다.

macOS 권한 프롬프트: uvx가 다른 앱의 데이터에 액세스하려고 합니다. 허용 안 함 / 허용.

구성

Claude Desktop 설정

uvx 사용 (권장)

{
    "mcpServers": {
        "apple-books-mcp": {
            "command": "uvx",
            "args": [ "apple-books-mcp@latest" ]
        }
    }
}

python 사용

{
    "mcpServers": {
        "apple-books-mcp": {
            "command": "python",
            "args": ["-m", "apple_books_mcp"]
        }
    }
}

Docker 사용

{
    "mcpServers": {
        "apple-books-mcp": {
            "command": "docker",
            "args": [
                "run", "-i", "--rm",
                "-v", "~/Library/Containers/com.apple.iBooksX/Data/Documents:/root/Library/Containers/com.apple.iBooksX/Data/Documents:ro",
                "ghcr.io/vgnshiyer/apple-books-mcp:latest"
            ]
        }
    }
}

예정된 기능

[ ] PDF 콘텐츠 액세스 (현재는 EPUB만 가능)
[ ] CFI → 단락 해결을 통한 더 완전한 주석 문맥 제공

기여

이 프로젝트에 기여해 주셔서 감사합니다!

개발

이 저장소를 복제한 경우 아래 구성으로 Claude Desktop을 사용하여 테스트할 수 있습니다:

uv venv를 사용하여 가상 환경을 만들고 종속성을 설치하세요.

uv venv
uv sync

디버깅

Claude Desktop 사용 시

{
    "mcpServers": {
        "apple-books-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/apple-books-mcp/",
                "run",
                "apple_books_mcp",
                "-v"
            ]
        }
    }
}

인스펙터 사용 시

npx @modelcontextprotocol/inspector uvx apple-books-mcp

이슈 열기

버그가 발생하거나, 기능 요청이 있거나, 프로젝트와 관련된 논의를 원하시면 GitHub 저장소에 이슈를 열어주세요. 이슈를 열 때 다음을 제공해 주세요:

버그 리포트: 문제를 자세히 설명하세요. 가능하다면 버그를 재현하는 단계와 오류 메시지 또는 스크린샷을 포함하세요.

기능 요청: 프로젝트에 추가하고 싶은 새로운 기능을 명확하게 설명하세요. 이 기능이 왜 유용한지 문맥을 제공하세요.

일반 토론: 프로젝트와 관련된 더 넓은 주제에 대해 자유롭게 토론을 시작하세요.

기여 방법

1️⃣ GitHub 저장소 https://github.com/vgnshiyer/apple-books-mcp 포크 2️⃣ 변경 사항을 위한 새 브랜치 생성 (git checkout -b feature/my-new-feature) 3️⃣ 변경 사항을 적용하고 철저히 테스트 4️⃣ 변경 사항을 푸시하고 main으로 Pull Request 열기

변경 사항에 대한 명확한 제목과 설명을 제공해 주세요.

라이선스

Apple Books MCP는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

2dResponse time

6dRelease cycle

15Releases (12mo)

Commit activity

Issues opened vs closed

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

apple-books-mcp
Note Taking Knowledge & Memory
ragmha
A
license
Not graded
quality
C
maintenance
Enables AI clients to read and write local Apple Books library, collections, and annotations. Supports searching, exporting, and modifying books and highlights via MCP tools.
Updated 4 months ago (2026-05-13 09:45 UTC)
MIT
Co-Reading MCP
Note Taking Knowledge & Memory File Systems
idleprocesscc
A
license
B
quality
B
maintenance
A local MCP server that gives Claude a durable reading room for EPUB and plain text books, enabling chunk-by-chunk navigation, annotations, progress tracking, and shared margin cards.
Updated 3 months ago (2026-06-02 07:09 UTC)
26
103
MIT
book-notes-mcp
RAG Systems Knowledge & Memory Note Taking
ayush1298
F
license
Not graded
quality
D
maintenance
MCP server for processing raw book notes into structured, searchable knowledge using embeddings and semantic search.
Updated 4 months ago (2026-05-08 12:47 UTC)
Books Mandala MCPofficial
E-commerce & Retail Search
mandalatech
F
license
Not graded
quality
C
maintenance
MCP server enabling AI assistants to search, browse, and discover books from Books Mandala's live catalog of 50,000+ titles.
Updated a month ago (2026-07-23 19:13 UTC)
2

View all related MCP servers

Related MCP Connectors

mcp
Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.
Living Memory
An MCP memory server. One memory your agents share — across models, devices and apps.
mcp-server
Apple Developer Documentation with Semantic Search, RAG, and AI reranking for MCP clients

View all MCP Connectors

Appeared in Searches

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vgnshiyer/apple-books-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Apple Books MCP

한눈에 보기

사용 가능한 도구

컬렉션

도서

독서 상태

주석

라이브러리 통계

도서 콘텐츠

사용 가능한 리소스

사용 가능한 프롬프트

설치

uv 사용 (권장)

pip 사용

Docker 사용

최초 실행 권한 프롬프트 (macOS)

구성

Claude Desktop 설정

uvx 사용 (권장)

python 사용

Docker 사용

예정된 기능

기여

개발

디버깅

이슈 열기

기여 방법

라이선스

Maintenance

Resources

Looking for Admin?

Related MCP Servers

apple-books-mcp

Co-Reading MCP

book-notes-mcp

Books Mandala MCPofficial

Related MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API