Skylight MCP Server

Skylight カレンダー API 用の MCP（Model Context Protocol）サーバーです。Claude などの AI アシスタントが Skylight の家族カレンダー、家事、リストなどと連携できるようにします。

機能

• カレンダー: カレンダーのイベントを照会（「今日のカレンダーはどうなってる？」）

• 家事: 家事の表示と作成（「食器洗い機の空っぽにするを家事に追加して」）

• リスト: 食料品リストと ToDo リストを表示（「食料品リストには何が入ってる？」）

• タスク: タスクボックスに項目を追加（「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"
      }
    }
  }
}

AI 向けの手順

これを AI のカスタム指示またはシステムプロンプトにコピーしてください:

あなたは Skylight MCP サーバーにアクセスできます。Skylight は、カレンダー、家事、食料品リスト、食事、報酬を表示するスマートな家族用カレンダーディスプレイです。Skylight のツールを使って、家族のスケジュール管理や整理をサポートしてください。

ヒント:

• 家事を割り当てる前に get_family_members を呼び出してメンバー名を取得してください

• 食料品アイテムは、リストが指定されていない場合はメインの食料品リストにデフォルト設定されます

• 日付は「today」「tomorrow」、曜日名、または YYYY-MM-DD 形式を受け付けます

• 一部のツール（報酬、食事、写真）には Skylight Plus サブスクリプションが必要です

前提条件

• Node.js 18 以上

• アクティブなサブスクリプションを持つ Skylight アカウント

• Skylight フレーム ID（フレーム ID の確認方法を参照）

認証

MCP サーバーは 2 つの認証方法をサポートしています:

オプション 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 はリバースエンジニアリングされており、予告なく変更される可能性があります。自己責任で使用してください。