Google 캘린더 MCP 서버

Claude Desktop에서 Model Context Protocol(MCP)을 사용하여 Google 캘린더와 상호 작용하세요.

Google 캘린더 통합을 구현하는 TypeScript 기반 MCP 서버입니다. 핵심 MCP 개념을 보여주면서 다음과 같은 기능을 제공합니다.

• MCP URI를 통한 캘린더 이벤트 관리
• 이벤트 생성 및 수정 도구
• 캘린더 통찰력 생성을 위한 프롬프트

특징

자원

• MCP URI를 통해 캘린더 이벤트에 액세스
• 각 이벤트에는 제목, 시간, 설명 및 참석자가 있습니다.
• 적절한 MIME 유형을 사용한 구조화된 이벤트 데이터

도구

• create_event - 새 캘린더 이벤트 만들기
  • 제목, 시간 및 기타 이벤트 세부 정보를 매개변수로 사용합니다.
  • Google 캘린더 API와 직접 인터페이스
• list_events - 예정된 캘린더 이벤트 보기
• [구현한 다른 도구 추가]

프롬프트

• analyze_schedule - 캘린더에 대한 통찰력 생성
  • 예정된 이벤트를 내장 리소스로 포함합니다.
  • LLM 분석을 위한 구조화된 프롬프트를 반환합니다.
• [구현한 다른 프롬프트 추가]

필수 조건

• Node.js(v14 이상)
• 캘린더 API가 활성화된 Google Cloud 프로젝트
• OAuth 2.0 클라이언트 자격 증명

개발

devbox.sh 의 지침에 따라 devbox를 설치하세요.

지엑스피1

프로젝트 디렉토리에서 devbox를 초기화합니다.

Devbox 셸을 시작합니다.

종속성 설치:

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

설치

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

첫 번째 설정

1. Google Cloud 사용자 인증 정보를 설정하세요.
   • Google Cloud Console 로 이동
   • 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
   • Google 캘린더 API 활성화
   • OAuth 2.0 자격 증명 만들기(데스크톱 애플리케이션 유형)
   • 클라이언트 비밀 JSON 파일을 다운로드하세요
   • .client_secret.json 으로 이름을 바꾸고 프로젝트 루트에 넣으세요.
2. 초기 인증:
   • 서버를 처음 실행하면 인증 URL이 제공됩니다.
   • 브라우저에서 URL을 방문하세요
   • 요청된 권한을 부여합니다
   • 제공된 승인 코드를 복사하세요
   • 코드를 CLI 프롬프트에 다시 붙여넣습니다.

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.