Skylight MCP Server

MCP-сервер (Model Context Protocol) для Skylight Calendar API. Позволяет ИИ-ассистентам, таким как Claude, взаимодействовать с вашим семейным календарём Skylight, обязанностями, списками и не только.

Возможности

• Календарь: Запрос событий календаря («Что у меня в календаре на сегодня?»)

• Обязанности: Просмотр и создание обязанностей («Добавить разгрузку посудомоечной машины в обязанности»)

• Списки: Просмотр списков покупок и списков дел («Что в списке покупок?»)

• Задачи: Добавление элементов в список задач («Добавь XYZ в мой список задач»)

• Семья: Просмотр членов семьи и устройств

• Награды: Проверка бонусных баллов и доступных наград

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"
      }
    }
  }
}

Инструкции для ИИ

Скопируйте это в пользовательские инструкции или системный промпт вашего ИИ:

У вас есть доступ к MCP-серверу Skylight. Skylight — это умный семейный календарь, который показывает календари, обязанности, списки покупок, приёмы пищи и награды. Используйте инструменты Skylight для управления семейным расписанием и организацией.

Советы:

• Вызывайте get_family_members перед назначением обязанностей, чтобы получить имена участников

• Элементы списка покупок по умолчанию добавляются в основной список покупок, если список не указан

• Даты принимают "today", "tomorrow", названия дней или формат YYYY-MM-DD

• Некоторые инструменты (награды, приёмы пищи, фото) требуют подписки Skylight Plus

Предварительные требования

• Node.js 18+

• Учётная запись Skylight с активной подпиской

• Ваш Frame ID Skylight (см. Поиск вашего Frame 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

Поиск вашего Frame ID

Вам всё ещё нужно найти ваш frame ID (идентификатор домохозяйства):

1. Используйте прокси-инструмент (Proxyman, Charles или mitmproxy)

2. Перехватите любой API-запрос из приложения Skylight

3. Посмотрите на путь URL: /api/frames/{frameId}/...

4. Пример: /api/frames/abc123/chores → frame 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 были задокументированы с помощью проекта skylight-api, который преобразует сетевой трафик браузера (HAR-файлы) в спецификацию OpenAPI.

Ресурсы API:

• Интерактивная документация API (Swagger UI)

• Справочник API (ReDoc)

• Спецификация OpenAPI

Если вы обнаружите новые конечные точки API или найдёте проблемы в текущей документации, пожалуйста, внесите вклад в репозиторий skylight-api.

Участие в разработке

Вклад приветствуется! Вот как вы можете помочь:

1. Сделайте форк репозитория и создайте ветку для функции

2. Внесите изменения с понятными и описательными коммитами

3. Запустите тесты (npm test) и линтер (npm run lint) перед отправкой

4. Откройте pull request с описанием ваших изменений

Настройка среды разработки

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

Области для вклада

• Добавление поддержки новых конечных точек Skylight API

• Улучшение обработки ошибок и крайних случаев

• Улучшение документации

• Написание дополнительных тестов

Проблемы и поддержка

• Отчёты об ошибках: Откройте issue с шагами для воспроизведения

• Запросы на функции: Откройте issue с описанием сценария использования

• Вопросы: Начните обсуждение или откройте issue

Пожалуйста, укажите соответствующие детали, такие как версия Node.js, сообщения об ошибках и конфигурация (с удалёнными чувствительными значениями).

Лицензия

MIT

Отказ от ответственности

Это неофициальная интеграция. Skylight API был реверс-инжинирингован и может меняться без предупреждения. Используйте на свой страх и риск.