MCP Apple Notes

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides semantic search and retrieval capabilities for Apple Notes, allowing users to list, search, retrieve, and create notes in their Apple Notes app.

  • Required for Apple Notes integration, leveraging native macOS functionality to access and manipulate notes.

MCP 애플 노트

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

특징

  • 🔍 온디바이스 임베딩 모델을 사용한 의미 검색
  • 📝 전체 텍스트 검색 기능
  • 💾 LanceDB를 사용한 벡터 저장
  • 🍎 기본 Apple Notes 통합

필수 조건

  • macOS(Apple Notes 통합에 필요)
  • Bun JavaScript 런타임

설치

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

지엑스피1

  1. 종속성 설치:
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

-
security - not tested
F
license - not found
-
quality - not tested

Apple Notes 콘텐츠의 의미적 검색 및 회수를 가능하게 하는 모델 컨텍스트 프로토콜 서버로, AI 어시스턴트가 기기 내장 기능을 사용하여 메모에 접근하고, 메모를 검색하고, 메모를 생성할 수 있도록 해줍니다.

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Configuring in Cursor IDE
          2. Using the MCP Server
        2. Troubleshooting
          1. License
            ID: oey0kokhxb