📝 Apple Notes MCP 서버

Apple Notes MCP 서버는 자연어를 통해 Apple Notes와 원활하게 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. Claude나 다른 AI 도우미를 사용하여 손쉽게 노트를 만들고, 검색하고, 불러오세요! 🎉

🎯 특징

• 노트 만들기: 제목, 내용, 태그를 사용하여 새로운 노트를 빠르게 만드세요 📝
• 노트 검색: 강력한 검색 기능을 사용하여 노트를 찾으세요 🔍
• 콘텐츠 검색: 제목으로 모든 메모의 전체 내용을 가져옵니다. 📖
• iCloud 통합: iCloud Notes 계정과 직접 연동됩니다 ☁️

🚀 시작하기

필수 조건

1. Apple Notes 앱이 구성된 macOS
2. Node.js(버전 20.0.0 이상)
3. Yarn 패키지 관리자

설치

1. 저장소를 복제합니다.지엑스피1
2. 종속성 설치:
   yarn install
3. 프로젝트를 빌드하세요:
   yarn build
4. 서버를 시작합니다:
   yarn start
5. Claude Desktop을 구성하세요. claude_desktop_config.json 파일을 다음과 같이 업데이트하세요.
   { "mcpServers": { "apple-notes": { "command": "yarn", "args": ["start"], "cwd": "/path/to/mcp-apple-notes" } } }

   참고: /path/to/mcp-apple-notes 복제된 저장소의 실제 경로로 바꾸세요. 명령을 처음 실행할 때 스크립트가 Apple Notes에 접근할 수 있도록 권한을 부여해야 할 수도 있습니다.

MCP 서버 초기화

서버가 성공적으로 시작되면 다음이 표시됩니다.

이제 서버에서 메모 작업을 처리할 준비가 되었습니다! 🎉

🛠️ 사용법

사용 가능한 도구

1. 메모 만들기
   • 설명: Apple Notes에서 새 메모를 만듭니다.
   • 매개변수:
     { title: string; // The title of the note content: string; // The content of the note tags?: string[]; // Optional tags for the note }
   • 응답 예시:
     Note created: My New Note
2. 검색 노트
   • 설명: 제목으로 노트 검색
   • 매개변수:
     { query: string; // The search query }
   • 응답 예시:
     Meeting Notes Shopping List Ideas for Project
3. 노트 내용 가져오기
   • 설명: 특정 노트의 전체 내용을 검색합니다.
   • 매개변수:
     { title: string; // The exact title of the note }
   • 응답 예시:
     [Full content of the note]

📚 예시 사용 사례

1. 빠른 노트 필기

회의나 브레인스토밍 세션 중에 메모를 작성하세요.

2. 정보 검색

필요할 때 특정 메모를 검색하세요.

3. 콘텐츠 검토

특정 메모의 전체 내용을 알아보세요.

⚡ 최상의 결과를 위한 팁

• Apple Notes 앱이 iCloud로 올바르게 구성되었는지 확인하세요.
• 검색성을 높이려면 설명적인 제목을 사용하세요.
• 더 나은 구성을 위해 노트를 만들 때 관련 태그를 포함하세요.

🔧 개발

이 프로젝트는 TypeScript를 사용하며 최신 ES 모듈 패턴을 따릅니다. 주요 파일:

• src/index.ts : 메인 서버 구현
• src/services/appleNotesManager.ts : 핵심 노트 관리 기능
• src/utils/applescript.ts : AppleScript 통합 유틸리티

개발 컨테이너

VS Code 사용자를 위해 다음을 제공하는 개발 컨테이너 구성이 제공됩니다.

• TypeScript Node.js 환경
• 코드 포맷팅에 더 좋음
• 자동 종속성 설치

📄 라이센스

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

Apple Notes 사용자를 위해 ❤️로 만들었습니다