MCP iCal Server

MCP iCal 서버

🗓️ macOS용 자연어 캘린더 관리

🌟 개요

자연어를 사용하여 macOS 캘린더와의 상호 작용 방식을 혁신하세요! mcp-ical 서버는 모델 컨텍스트 프로토콜(MCP)을 활용하여 캘린더 관리를 대화형 환경으로 전환합니다.

지엑스피1

✨ 특징

📅 이벤트 생성

자연어를 즉시 일정 이벤트로 변환하세요!

지원되는 기능

• 사용자 정의 달력 선택
• 위치 및 참고사항
• 스마트 리마인더
• 반복되는 이벤트

전문 사용자 예

🔍 스마트 일정 관리 및 가용성

자연스러운 쿼리로 일정에 빠르게 접근하세요:

✏️ 지능형 이벤트 업데이트

이벤트를 자연스럽게 수정하세요:

업데이트 기능

• 시간 및 날짜 수정
• 캘린더 전송
• 위치 업데이트
• 추가 사항 참고
• 알림 조정
• 반복되는 패턴 변화

📊 캘린더 관리

• 사용 가능한 모든 캘린더 보기
• 스마트 캘린더 제안
• iCloud로 구성 시 원활한 Google 캘린더 통합

💡 전문가 팁 : 사용자 지정 캘린더에서 이벤트를 생성할 수 있으므로, Google 캘린더를 iCloud 캘린더와 동기화했다면 이 MCP 서버를 사용하여 Google 캘린더에도 이벤트를 생성할 수 있습니다! 이벤트를 생성/업데이트할 때 Google 캘린더를 지정하기만 하면 됩니다.

🚀 빠른 시작

💡 참고 : 이 지침은 Claude for Desktop을 사용하여 MCP 서버를 설정하는 데 중점을 두고 있지만, 이 서버는 모든 MCP 호환 클라이언트와 함께 사용할 수 있습니다. 다양한 클라이언트 사용에 대한 자세한 내용은 MCP 설명서를 참조하세요.

필수 조건

• uv 패키지 관리자
• 캘린더 앱이 구성된 macOS
• MCP 클라이언트 - 데스크톱용 Claude가 권장됩니다.

설치

이 MCP 서버는 모든 MCP 호환 클라이언트와 함께 사용할 수 있지만, 아래 지침은 데스크톱용 Claude와 함께 사용하기 위한 것입니다.

1. 복제 및 설정
   # Clone the repository git clone https://github.com/Omar-V2/mcp-ical.git cd mcp-ical # Install dependencies uv sync
2. 데스크톱용 Claude 구성~/Library/Application\ Support/Claude/claude_desktop_config.json 생성하거나 편집합니다.
   { "mcpServers": { "mcp-ical": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical", "run", "mcp-ical" ] } } }
3. 캘린더 액세스를 위한 Claude 실행

   ⚠️ 중요 : 캘린더 권한을 제대로 요청하려면 Claude를 터미널에서 실행해야 합니다. Finder에서 직접 실행하면 권한 요청이 표시되지 않습니다.

   터미널에서 다음 명령을 실행하세요.
   /Applications/Claude.app/Contents/MacOS/Claude

   ⚠️ 경고 : 수동으로 일정 접근 권한을 부여 할 수도 있지만, 이 경우 시스템 파일을 수정해야 하므로 관련 위험을 이해하는 경우에만 수행해야 합니다.

4. 사용을 시작하세요!
   Try: "What's my schedule looking like for next week?"

🔑 참고 : 캘린더 관련 명령을 처음 사용하면 macOS에서 캘린더 접근 권한을 묻는 메시지가 표시됩니다. 이 메시지는 위에서 설명한 대로 터미널에서 Claude를 실행한 경우에만 나타납니다.

🧪 테스트

⚠️ 경고 : 테스트는 임시 캘린더와 이벤트를 생성합니다. 정리는 자동으로 진행되지만, 개발 환경에서만 테스트를 실행하세요.

🐛 알려진 문제

반복되는 이벤트

• 비표준 반복 일정은 항상 올바르게 설정되지 않을 수 있습니다.
• Haiku에 비해 Claude 3.5 Sonnet이 더 나은 결과를 보였습니다.
• 하루 종일 반복되는 이벤트에 대한 알림 시간은 하루 정도 차이가 있을 수 있습니다.

🤝 기여하기

피드백과 기여를 환영합니다. 참여 방법은 다음과 같습니다.

1. 저장소를 포크하세요
2. 기능 브랜치를 생성하세요
3. 변경 사항을 커밋하세요
4. 지점으로 밀어 넣기
5. 풀 리퀘스트 열기

📝 라이센스

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

🙏 감사의 말

• 모델 컨텍스트 프로토콜 로 구축됨
• PyObjC 로 구축된 macOS 캘린더 통합