MCP 애플 노트

Apple Notes에서의 의미 검색 및 회수를 위한 MCP(Model Context Protocol) 서버입니다.

특징

• 🔍 온디바이스 임베딩 모델을 사용한 의미 검색

• 📝 전체 텍스트 검색 기능

• 💾 LanceDB를 사용한 벡터 저장

• 🍎 기본 Apple Notes 통합

Related MCP server: MCP Apple Reminders

필수 조건

• macOS(Apple Notes 통합에 필요)

• Bun JavaScript 런타임

설치

1. 이 저장소를 복제하세요:

지엑스피1

2. 종속성 설치:

bun install

용법

커서 IDE에서 구성

1. 커서 IDE 열기

2. 설정 → 기능 → MCP로 이동하세요.

3. 다음 구성으로 새로운 MCP 서버를 추가합니다.

   • 이름 : Apple Notes

   • 유형 : 명령

   • 명령어 : /path/to/bun /path/to/mcp-apple-notes/index.ts``/path/to/bun Bun 실행 파일의 실제 경로로 바꾸고( which bun 사용하여 찾음) /path/to/mcp-apple-notes 이 저장소의 실제 경로로 바꿉니다.

4. 커서 IDE 재시작

MCP 서버 사용

구성이 완료되면 Claude와의 대화에서 다음 도구를 사용할 수 있습니다.

• list-notes : 모든 Apple Notes 제목을 나열합니다.

• index-notes : 의미 검색을 위해 노트를 인덱싱합니다(먼저 이 작업을 수행하세요)

• get-note : 제목으로 특정 노트를 검색합니다.

• search-notes : 의미 검색이나 키워드 검색을 사용하여 노트를 검색합니다.

• create-note : 지정된 제목과 내용으로 새 노트를 만듭니다.

문제 해결

문제가 발생하는 경우:

1. Cursor에서 MCP 서버 상태를 확인하여 서버가 실행 중인지 확인하세요.

2. MCP 서버 구성의 경로가 올바른지 확인하세요.

3. 오류 메시지를 보려면 터미널에서 직접 명령을 실행해보세요.

4. Apple Notes에 액세스할 수 있고 권한이 부여되었는지 확인하세요.

특허

MIT