🗓️ Kurly Growth Calendar MCP Server

Claude Desktop과 Cursor용 컬리 그로스팀 캘린더 통합 도구입니다.

✨ 주요 기능

🏖️ 휴가 일정: 팀원들의 연차, 반차, 퍼플 등 휴가 일정
🎉 공휴일: 대한민국 공휴일 정보
📅 이벤트: 배포일정, 회의 등 팀 이벤트
🎂 생일: 팀원 생일 정보
📋 통합 조회: 모든 캘린더 정보를 한번에

🚀 설치 방법

npm install -g kurly-growth-mcp

⚙️ Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json 파일에 다음 설정을 추가하세요:

{
  "mcpServers": {
    "kurly-growth-mcp": {
      "command": "kurly-growth-mcp"
    }
  }
}

⚙️ Cursor 설정

프로젝트 루트에 .cursor/mcp.json 파일을 생성하고 다음 설정을 추가하세요:

{
  "mcpServers": {
    "kurly-growth-mcp": {
      "command": "node",
      "args": ["dist/mcp.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

💡 참고:

먼저 npm run build로 TypeScript를 컴파일해야 합니다

전역으로 설치된 경우: "command": "kurly-growth-mcp"로 설정 가능

📱 설정 완료 후

Claude Desktop

Claude Desktop을 완전히 재시작하세요
새로운 대화를 시작하세요
도구가 활성화되었는지 확인하세요

Cursor

Cursor를 재시작하세요
Agent 모드에서 MCP 도구가 "Available Tools"에 나타나는지 확인하세요
"kurly growth 캘린더를 확인해주세요"와 같이 자연어로 요청하세요

🛠️ 사용 가능한 도구

도구명	설명	매개변수
`ping`	서버 연결 테스트	-
`get_all_events`	모든 캘린더 일정 조회	`date`, `startDate`, `endDate`
`get_growth_vacation_events`	휴가 캘린더만 조회	`date`, `startDate`, `endDate`
`get_holiday_events`	공휴일만 조회	`date`, `startDate`, `endDate`
`get_growth_event_events`	이벤트 일정만 조회	`date`, `startDate`, `endDate`
`get_birthday_events`	생일 일정만 조회	`date`, `startDate`, `endDate`

매개변수 설명

date: 특정 날짜 조회 (형식: YYYY-MM-DD)
startDate: 시작 날짜 (형식: YYYY-MM-DD)
endDate: 종료 날짜 (형식: YYYY-MM-DD)

📝 참고: 모든 매개변수는 선택사항입니다. 기본값으로 오늘 날짜가 사용됩니다.

💬 사용 예시

Claude Desktop이나 Cursor에서 다음과 같이 대화할 수 있습니다:

🗣️ "7월 전체 캘린더를 보여주세요"
🗣️ "이번 주 휴가자가 있나요?"
🗣️ "다음 주 공휴일을 알려주세요"
🗣️ "7월 15일 일정을 확인해주세요"
🗣️ "이번 달 생일자를 알려주세요"

📊 출력 예시

📋 전체 캘린더
📅 기간: 2025-07-01 ~ 2025-07-31
📊 총 일정: 42개

🎉 공휴일 (1건)
  📅 2025-07-17
    • 제헌절

🏖️ 휴가 (34건)
  📅 2025-07-01
    • 김재현 오후반반차
    • 송수아 오전반차
    • 박래형 휴가
    • 임해민 연차
  📅 2025-07-02
    • 김재현 오전 퍼플

🎂 생일 (1건)
  📅 2025-07-16
    • 박래형님 생일

🔄 업데이트

새 버전이 출시되면 다음 명령어로 업데이트하세요:

npm update -g kurly-growth-mcp

🏗️ 개발자 정보

현재 버전: v1.1.0
MCP 프로토콜: 2024-11-05 완전 지원
Node.js: 18.0.0 이상 필요

🐛 문제 해결

도구가 나타나지 않는 경우

버전 확인
```
npm list -g kurly-growth-mcp
```

캐시 클리어 후 재설치

npm uninstall -g kurly-growth-mcp
npm install -g kurly-growth-mcp@latest

Claude Desktop 완전 재시작

killall Claude
# 몇 초 후 Claude Desktop 재실행

연결 테스트

Claude Desktop이나 Cursor에서 다음과 같이 말해보세요:

"ping 도구로 연결을 테스트해주세요"

정상 응답:

✅ AWS MCP 서버 연결 성공!
🌍 서버 URL: http://43.201.67.0:3000
⏰ 응답 시간: 2025-07-11T07:00:00.000Z
📊 상태: 정상

📞 지원

문제가 있으시면 다음으로 연락주세요:

사내 슬랙: 그로스팀 채널

Made with ❤️ by Kurly Growth Team

Package detail

kurly-growth-mcp

readme