Skylight MCP 服务器

一个用于 Skylight 日历 API 的 MCP（模型上下文协议）服务器。使 Claude 等 AI 助手能够与您的 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"
      }
    }
  }
}

给 AI 的说明

将此内容复制到您的 AI 的自定义说明或系统提示中：

您可以访问 Skylight MCP 服务器。Skylight 是一款智能家庭日历显示器，可显示日历、家务、杂货清单、餐食和奖励。使用 Skylight 工具帮助管理家庭日程和组织。

提示：

• 在分配家务之前调用 get_family_members 以获取成员姓名

• 如果未指定列表，杂货项目默认添加到主杂货清单

• 日期接受“今天”、“明天”、星期名称或 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 端点使用 skylight-api 项目进行了文档化，该项目将浏览器网络流量（HAR 文件）转换为 OpenAPI 规范。

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 是逆向工程的，可能随时更改，恕不另行通知。使用风险自负。