Skylight MCP 서버

Skylight 캘린더 API용 MCP(Model Context Protocol) 서버입니다. Claude와 같은 AI 어시스턴트가 Skylight 가족 캘린더, 집안일, 목록 등을 상호작용할 수 있게 해줍니다.

기능

• 캘린더: 캘린더 일정 조회 ("오늘 내 캘린더에 뭐가 있지?")

• 집안일: 집안일 보기 및 생성 ("설거지정리기 비우기를 집안일에 추가해줘")

• 목록: 장보기 및 할 일 목록 보기 ("장보기 목록에 뭐가 있지?")

• 작업: 작업 상자에 항목 추가 ("내 작업 목록에 우유 추가해줘")

• 가족: 가족 구성원 및 기기 보기

• 보상: 보상 포인트 및 사용 가능한 보상 확인

Related MCP server: Google Calendar MCP Server

빠른 시작

설치

옵션 1: npm 패키지 (권장)

mcp.json:

{
  "mcpServers": {
    "skylight": {
      "command": "npx",
      "args": ["@eaglebyte/skylight-mcp"],
      "env": {
        "SKYLIGHT_EMAIL": "your_email@example.com",
        "SKYLIGHT_PASSWORD": "your_password",
        "SKYLIGHT_FRAME_ID": "your_frame_id"
      }
    }
  }
}

Claude Code:

claude mcp add skylight npx @eaglebyte/skylight-mcp \
  -e SKYLIGHT_EMAIL=your_email@example.com \
  -e SKYLIGHT_PASSWORD=your_password \
  -e SKYLIGHT_FRAME_ID=your_frame_id

옵션 2: 소스에서

git clone https://github.com/TheEagleByte/skylight-mcp.git
cd skylight-mcp && npm install && npm run build

그런 다음 mcp.json에서 사용:

{
  "mcpServers": {
    "skylight": {
      "command": "node",
      "args": ["/path/to/skylight-mcp/dist/index.js"],
      "env": {
        "SKYLIGHT_EMAIL": "your_email@example.com",
        "SKYLIGHT_PASSWORD": "your_password",
        "SKYLIGHT_FRAME_ID": "your_frame_id"
      }
    }
  }
}

AI를 위한 지침

이 내용을 AI의 사용자 지정 지침이나 시스템 프롬프트에 복사하세요:

Skylight MCP 서버에 접근할 수 있습니다. Skylight는 캘린더, 집안일, 장보기 목록, 식사, 보상을 표시하는 스마트 가족 캘린더 디스플레이입니다. Skylight 도구를 사용하여 가족 일정과 조직을 관리하세요.

팁:

• 집안일을 배정하기 전에 get_family_members를 호출하여 구성원 이름을 확인하세요

• 장보기 항목은 목록을 지정하지 않으면 기본 장보기 목록에 추가됩니다

• 날짜는 "today", "tomorrow", 요일 이름 또는 YYYY-MM-DD 형식을 허용합니다

• 일부 도구(보상, 식사, 사진)는 Skylight Plus 구독이 필요합니다

사전 요구 사항

• Node.js 18 이상

• 활성 구독이 있는 Skylight 계정

• Skylight 프레임 ID (프레임 ID 찾기 참조)

인증

MCP 서버는 두 가지 인증 방법을 지원합니다:

옵션 1: 이메일/비밀번호 (권장)

Skylight 계정 자격 증명을 사용하세요. 서버가 자동으로 로그인하고 토큰을 관리합니다.

SKYLIGHT_EMAIL=your_email@example.com
SKYLIGHT_PASSWORD=your_password
SKYLIGHT_FRAME_ID=your_frame_id

옵션 2: 수동 토큰 (레거시)

프록시 도구를 사용하여 Skylight 앱에서 토큰을 캡처하세요.

SKYLIGHT_TOKEN=your_token_here
SKYLIGHT_FRAME_ID=your_frame_id
SKYLIGHT_AUTH_TYPE=bearer

프레임 ID 찾기

여전히 프레임 ID(가구 식별자)를 찾아야 합니다:

1. 프록시 도구(Proxyman, Charles 또는 mitmproxy)를 사용하세요

2. Skylight 앱에서 API 요청을 캡처하세요

3. URL 경로를 확인하세요: /api/frames/{frameId}/...

4. 예: /api/frames/abc123/chores → 프레임 ID는 abc123입니다

구성

.env 파일 예시:

# Email/password auth (recommended)
SKYLIGHT_EMAIL=your_email@example.com
SKYLIGHT_PASSWORD=your_password
SKYLIGHT_FRAME_ID=your_frame_id
SKYLIGHT_TIMEZONE=America/New_York

사용 가능한 도구

캘린더 도구

집안일 도구

목록 도구

작업 도구

가족 도구

보상 도구

예시 쿼리

구성이 완료되면 Claude에게 다음과 같이 물어볼 수 있습니다:

• "오늘 내 캘린더에 뭐가 있지?"

• "이번 주에 해야 할 집안일은 뭐야?"

• "내일 집안일에 '쓰레기 버리기' 추가해줘"

• "장보기 목록에 뭐가 있지?"

• "내 작업 목록에 우유 추가해줘"

• "Skylight에 가족 구성원은 누구야?"

• "각자 보상 포인트가 얼마나 돼?"

개발

# Run in development mode (with hot reload)
npm run dev

# Build
npm run build

# Run tests
npm test

# Type check
npm run typecheck

API 문서

이 MCP 서버는 리버스 엔지니어링된 Skylight API를 기반으로 구축되었습니다. API 엔드포인트는 브라우저 네트워크 트래픽(HAR 파일)을 OpenAPI 사양으로 변환하는 skylight-api 프로젝트를 사용하여 문서화되었습니다.

API 리소스:

• 대화형 API 문서 (Swagger UI)

• API 참조 (ReDoc)

• OpenAPI 사양

새로운 API 엔드포인트를 발견하거나 현재 문서에 문제가 있으면 skylight-api 저장소에 기여해 주세요.

기여

기여는 환영합니다! 도움을 주는 방법은 다음과 같습니다:

1. 저장소를 포크하고 기능 브랜치를 만드세요

2. 명확하고 설명적인 커밋으로 변경 사항을 적용하세요

3. 제출 전에 테스트(npm test)와 린팅(npm run lint)을 실행하세요

4. 변경 사항에 대한 설명과 함께 풀 리퀘스트를 여세요

개발 설정

git clone https://github.com/TheEagleByte/skylight-mcp.git
cd skylight-mcp
npm install
npm run dev  # Start with hot reload

기여 분야

• 새로운 Skylight API 엔드포인트 지원 추가

• 오류 처리 및 엣지 케이스 개선

• 문서 개선

• 추가 테스트 작성

이슈 및 지원

• 버그 신고: 재현 단계를 포함해 이슈 열기

• 기능 요청: 사용 사례를 설명하는 이슈 열기

• 질문: 토론 시작 또는 이슈 열기

Node.js 버전, 오류 메시지, 구성(민감한 값은 삭제)과 같은 관련 세부 정보를 포함해 주세요.

라이선스

MIT

고지 사항

이것은 비공식 통합입니다. Skylight API는 리버스 엔지니어링된 것이며 예고 없이 변경될 수 있습니다. 사용에 따른 책임은 본인에게 있습니다.