apple-notes-mcp

Claude Desktop을 위한 Apple Notes 모델 컨텍스트 프로토콜 서버입니다.

로컬 Apple Notes 데이터베이스를 읽고 Claude Desktop에 제공하세요.

이제 클로드는 당신이 가장 잊고 있던 메모를 검색하여 당신에 대해 더 많이 알 수 있게 되었습니다.

잘못될 수 있다는 것을 알아두세요.

구성 요소

자원

이 서버는 Apple Notes를 읽고 쓸 수 있는 기능을 구현합니다.

도구

서버는 여러 가지 프롬프트를 제공합니다.

• get-all-notes : 모든 노트를 가져옵니다.
• read-note : 특정 노트의 전체 내용을 가져옵니다.
• search-notes : 노트를 검색합니다.

누락된 기능:

• 암호화된 메모(ZISPASSWORDPROTECTED) 처리 불가
• 고정된 노트 필터링을 지원하지 않습니다.
• 클라우드 동기화 상태 처리 없음
• 첨부 파일 콘텐츠 검색이 누락되었습니다.
• 체크리스트 상태(ZHASCHECKLIST)에 대한 지원이 없습니다.
• 노트를 생성하거나 편집할 수 없습니다.

빠른 시작

서버를 설치하세요

Claude를 위해 로컬로 서버를 설치하려면 uv를 사용하는 것이 좋습니다.

지엑스피1

또는

아래 설명한 대로 구성을 추가하세요.

클로드 데스크탑

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

참고: uv 에 대한 직접 경로를 사용해야 할 수도 있습니다. which uv 사용하여 경로를 찾으세요.

개발/미공개 서버 구성

게시된 서버 구성

Mac OS 디스크 권한

서버에 전체 디스크 접근 권한을 부여해야 합니다. Apple Notes SQLite 데이터베이스가 macOS 파일 시스템 깊숙이 중첩되어 있기 때문입니다.

나중에 이것이 더 불편하거나 Apple Notes에 추가/첨부 기능을 시작하려면 AppleScript 솔루션을 고려해 볼 수도 있습니다.

개발

건축 및 출판

배포를 위해 패키지를 준비하려면:

1. 종속성 동기화 및 잠금 파일 업데이트:

2. 패키지 배포 빌드:

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

3. PyPI에 게시:

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

• 토큰: --token 또는 UV_PUBLISH_TOKEN
• 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

소스 코드

소스 코드는 GitHub 에서 확인할 수 있습니다.

기여하다

여러분의 아이디어와 피드백을 Bluesky 에 보내거나 이슈를 개설해 주세요.