MCP 애플 노트

Apple Notes에서 의미 검색 및 RAG(Retrieval Augmented Generation)를 지원하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이를 통해 Claude와 같은 AI 비서가 대화 중에 Apple Notes를 검색하고 참조할 수 있습니다.

특징

• 🔍 all-MiniLM-L6-v2 온디바이스 임베딩 모델을 사용하여 Apple Notes에서 의미 검색

• 📝 전체 텍스트 검색 기능

• 📊 LanceDB를 사용한 벡터 저장

• 🤖 AI 어시스턴트 통합을 위한 MCP 호환 서버

• 🍎 JXA를 통한 기본 Apple Notes 통합

• 🏃‍♂️ 완전 로컬 실행 - API 키 필요 없음

Related MCP server: Bear Notes MCP Server with RAG

필수 조건

• 혈액 요소 질소

• 클로드 데스크탑

설치

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

bun install

용법

1. Claude 데스크톱 앱을 열고 설정 -> 개발자 -> 구성 편집으로 이동합니다.

2. claude_desktop_config.json 열고 다음 항목을 추가합니다.

{
  "mcpServers": {
    "local-machine": {
      "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
      "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"]
    }
  }
}

중요: <YOUR_USER_NAME> 실제 사용자 이름으로 바꾸세요.

3. Claude 데스크톱 앱을 다시 시작하세요. 다음과 같은 화면이 표시됩니다.

4. 먼저 메모 색인을 생성하세요. Claude에게 "내 메모 색인 생성" 또는 "내 Apple Notes 색인 생성"과 같이 말하여 메모 색인을 생성해 달라고 요청하세요.

문제 해결

로그를 보려면:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
# or
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

토도스

• [ ] Apple 메모는 HTML 형식으로 반환됩니다. 이를 Markdown으로 변환하여 임베드해야 합니다.

• [ ] 재귀적 텍스트 분할기 또는 마크다운 텍스트 분할기를 사용하여 청크 소스 콘텐츠 분할

• [ ] 사용자 정의 임베딩 모델을 사용하는 옵션 추가

• [ ] DB에 대한 더 많은 제어 - 정리, 사용자 정의 쿼리 등

• [x] Claude를 통해 Notes에 메모 저장