Servidor MCP de Skylight

Un servidor MCP (Model Context Protocol) para la API de Skylight Calendar. Permite que asistentes de IA como Claude interactúen con tu calendario familiar de Skylight, tareas domésticas, listas y más.

Características

• Calendario: Consulta eventos del calendario ("¿Qué hay en mi calendario hoy?")

• Tareas domésticas: Ver y crear tareas ("Añade vaciar el lavavajillas a las tareas")

• Listas: Ver listas de compras y de tareas pendientes ("¿Qué hay en la lista de la compra?")

• Tareas: Añadir elementos al cuadro de tareas ("Añade XYZ a mi lista de tareas")

• Familia: Ver miembros de la familia y dispositivos

• Recompensas: Consultar puntos de recompensa y recompensas disponibles

Related MCP server: Google Calendar MCP Server

Inicio rápido

Instalación

Opción 1: Paquete npm (recomendado)

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

Opción 2: Desde el código fuente

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

Luego úsalo en 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"
      }
    }
  }
}

Instrucciones para la IA

Copia esto en las instrucciones personalizadas de tu IA o en el prompt del sistema:

Tienes acceso al servidor MCP de Skylight. Skylight es una pantalla de calendario familiar inteligente que muestra calendarios, tareas domésticas, listas de la compra, comidas y recompensas. Usa las herramientas de Skylight para ayudar a gestionar los horarios y la organización familiar.

Consejos:

• Llama a get_family_members antes de asignar tareas para obtener los nombres de los miembros

• Los artículos de la compra se añaden por defecto a la lista principal de la compra si no se especifica ninguna lista

• Las fechas aceptan "hoy", "mañana", nombres de días o formato AAAA-MM-DD

• Algunas herramientas (recompensas, comidas, fotos) requieren una suscripción a Skylight Plus

Requisitos previos

• Node.js 18+

• Una cuenta de Skylight con una suscripción activa

• Tu ID de marco de Skylight (consulta Cómo encontrar tu ID de marco)

Autenticación

El servidor MCP admite dos métodos de autenticación:

Opción 1: Correo electrónico/Contraseña (recomendado)

Usa tus credenciales de cuenta de Skylight. El servidor iniciará sesión automáticamente y gestionará los tokens.

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

Opción 2: Token manual (heredado)

Captura un token de la aplicación Skylight usando una herramienta de proxy.

SKYLIGHT_TOKEN=your_token_here
SKYLIGHT_FRAME_ID=your_frame_id
SKYLIGHT_AUTH_TYPE=bearer

Cómo encontrar tu ID de marco

Aún necesitas encontrar tu ID de marco (el identificador del hogar):

1. Usa una herramienta de proxy (Proxyman, Charles o mitmproxy)

2. Captura cualquier solicitud de API de la aplicación Skylight

3. Observa la ruta de la URL: /api/frames/{frameId}/...

4. Ejemplo: /api/frames/abc123/chores → el ID de marco es abc123

Configuración

Ejemplo de archivo .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

Herramientas disponibles

Herramientas de calendario

Herramientas de tareas domésticas

Herramientas de listas

Herramientas de tareas

Herramientas de familia

Herramientas de recompensas

Ejemplos de consultas

Una vez configurado, puedes preguntar a Claude cosas como:

• "¿Qué hay en mi calendario hoy?"

• "¿Qué tareas domésticas tengo que hacer esta semana?"

• "Añade 'sacar la basura' a mis tareas para mañana"

• "¿Qué hay en la lista de la compra?"

• "Añade leche a mi lista de tareas"

• "¿Quiénes son los miembros de la familia en Skylight?"

• "¿Cuántos puntos de recompensa tiene cada persona?"

Desarrollo

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

# Build
npm run build

# Run tests
npm test

# Type check
npm run typecheck

Documentación de la API

Este servidor MCP está construido sobre la API de Skylight de ingeniería inversa. Los endpoints de la API se documentaron usando el proyecto skylight-api, que convierte el tráfico de red del navegador (archivos HAR) en una especificación OpenAPI.

Recursos de la API:

• Documentación interactiva de la API (Swagger UI)

• Referencia de la API (ReDoc)

• Especificación OpenAPI

Si descubres nuevos endpoints de la API o encuentras problemas con la documentación actual, contribuye al repositorio skylight-api.

Contribuciones

¡Las contribuciones son bienvenidas! Así es como puedes ayudar:

1. Haz un fork del repositorio y crea una rama de características

2. Haz tus cambios con confirmaciones claras y descriptivas

3. Ejecuta las pruebas (npm test) y el linting (npm run lint) antes de enviar

4. Abre una solicitud de extracción con una descripción de tus cambios

Configuración de desarrollo

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

Áreas para contribuir

• Añadir soporte para nuevos endpoints de la API de Skylight

• Mejorar el manejo de errores y casos límite

• Mejorar la documentación

• Escribir pruebas adicionales

Problemas y soporte

• Informes de errores: Abre un problema con pasos para reproducir

• Solicitudes de funciones: Abre un problema describiendo el caso de uso

• Preguntas: Inicia una discusión o abre un problema

Incluye detalles relevantes como tu versión de Node.js, mensajes de error y configuración (con valores sensibles redactados).

Licencia

MIT

Aviso legal

Esta es una integración no oficial. La API de Skylight se ha obtenido mediante ingeniería inversa y puede cambiar sin previo aviso. Úsala bajo tu propio riesgo.