Integrations
Provides tools for interacting with Apple Books, allowing access to book collections, detailed book information, and annotation management including highlights and notes.
Provides support for the developer through donation links to Buy Me A Coffee platform.
Facilitates contribution to the project through the GitHub repository, including issue reporting and pull request submission.
애플 북스 MCP
Apple Books용 MCP(Model Context Protocol) 서버.
한눈에 보기
- Claude에게 최근 하이라이트를 요약해 달라고 요청하세요.
- Claude에게 도서관의 책을 장르별로 정리하도록 요청하세요.
- Claude에게 귀하의 독서 기록을 기반으로 유사한 책을 추천해 달라고 요청하세요.
- Claude에게 같은 주제에 대해 읽은 다른 책들의 노트를 비교해 달라고 요청하세요.
https://github.com/user-attachments/assets/77a5a29b-bfd7-4275-a4af-8d6c51a4527e
그리고 훨씬 더 많은 것들!
사용 가능한 도구
| 도구 | 설명 | 매개변수 |
|---|---|---|
| 리스트_컬렉션() | 모든 컬렉션 나열 | 없음 |
| 컬렉션_도서_받기(컬렉션_아이디) | 컬렉션에 있는 모든 책을 가져옵니다 | 컬렉션_id: str |
| 컬렉션 설명(컬렉션_ID) | 컬렉션의 세부 정보를 얻으세요 | 컬렉션_id: str |
| 모든 책 목록() | 모든 책 나열 | 없음 |
| get_book_annotations(책_아이디) | 책에 대한 모든 주석 가져오기 | book_id: 문자열 |
| 책 설명(책_아이디) | 특정 책의 세부 정보를 얻으세요 | book_id: 문자열 |
| 모든 주석 나열() | 모든 주석 나열 | 없음 |
| 색상별 하이라이트 가져오기(색상) | 색상별로 모든 하이라이트를 얻으세요 | 색상: str |
| 검색_강조_텍스트(텍스트) | 강조된 텍스트로 강조 표시 검색 | 텍스트: str |
| 검색_노트(노트) | 노트 검색 | 참고: str |
| 전체 텍스트 검색(텍스트) | 주어진 텍스트가 포함된 주석을 검색합니다. | 텍스트: str |
| 최근 주석() | 가장 최근의 주석 10개를 받으세요 | 없음 |
| 설명_주석(주석_ID) | 주석의 세부 정보 가져오기 | 주석_id: str |
설치
uv 사용(권장)
uvx를 사용하면 apple-books-mcp를 직접 실행할 수 있습니다(설치하지 않고도).
지엑스피1
pip 사용하기
설치 후 다음을 사용하여 서버를 실행할 수 있습니다.
구성
클로드 데스크탑 설정
uvx 사용(권장)
파이썬을 사용하여
곧 출시될 기능
- [ ] docker 지원 추가
- [ ] 리소스 지원 추가
- [ ] 컬렉션 편집 지원
- [ ] 편집 하이라이트 지원
기부금
이 프로젝트에 기여해주셔서 감사합니다!
개발
이 저장소를 복제한 경우 아래 구성으로 Claude Desktop을 사용하여 테스트할 수 있습니다.
uv venv 사용하여 가상 환경을 만들고 종속성을 설치합니다.
디버깅
Claude Desktop과 함께
검사관과 함께
개방형 문제
버그가 발견되거나, 기능 요청이 있거나, 프로젝트와 관련된 논의 사항이 있으시면 GitHub 저장소에 이슈를 등록해 주세요. 이슈를 등록하실 때는 다음 정보를 제공해 주세요.
버그 리포트 : 문제를 자세히 설명해 주세요. 가능하다면 버그를 재현하는 단계와 오류 메시지 또는 스크린샷을 함께 첨부해 주세요.
기능 요청 : 프로젝트에 추가하고 싶은 새로운 기능을 명확하게 설명하세요. 이 기능이 왜 유용한지 구체적인 설명을 제공하세요.
일반 토론 : 프로젝트와 관련된 더 광범위한 주제에 대해 자유롭게 토론을 시작해 보세요.
기여하다
1️⃣ GitHub 저장소를 포크하세요 https://github.com/vgnshiyer/apple-books-mcp
2️⃣ 변경 사항에 대한 새로운 브랜치를 만듭니다(git checkout -b feature/my-new-feature).
3️⃣ 변경 사항을 적용하고 철저히 테스트하세요.
4️⃣ 변경 사항을 푸시하고 main 에 풀 리퀘스트를 엽니다.
변경 사항에 대한 명확한 제목과 설명을 제공해 주세요.
특허
Apple Books MCP는 Apache 2.0 라이선스에 따라 제공됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.
This server cannot be installed
Apple Books MCP 서버는 정적인 도서 컬렉션을 대화형 지식 저장소로 변환하여 개인의 독서 여정과 AI 기능 간의 격차를 메워줍니다.