育儿MCP
MCP服务器和定时的WhatsApp消息给家长。查找孩子的学校信息 威尔玛斯塔 并将自动摘要发送到WhatsApp。
特性
Ajastetut WhatsApp viestit(调度程序)
Scheduler会自动向WhatsApp组或联系人发送三条消息:
| 消息 | 默认时间 | 内容 |
|---|---|---|
| 午餐 | 16:02 | 来自威尔玛的一天的家庭作业 |
| 明天时间表 | 20:03 | 明天上课时间+考试/特别节目 |
| 每周观察 | 周日 17:57 | 下周每天分组测试 |
可使用cron语法修改时间 config.json文件中。
MCP 工具 (Claude 集成)
育儿MCP通过MCP协议提供10个工具,Claude或其他法学硕士可以调用:
Wilma工具:
get_wilma_summary— 每日总结给所有学生(时间表,作业,考试,信息)get_wilma_schedule每天或每周的数字顺序get_wilma_exams即将进行的测试get_wilma_homework— 家庭作业get_wilma_news学校公告
WhatsApp的工具:
send_whatsapp_message向个人或组发送消息list_whatsapp_contacts— 列出联系方式list_whatsapp_groups— 组列表
摘要工具:
send_daily_summary— 编辑并将当天的摘要发送到WhatsAppsend_weekly_summary— 编译并将每周摘要发送到 WhatsApp
安装
npm install
npm run build设置
交互式的 setup 命令引导您到初始设置:
npm run setupSetup 执行以下操作:
- WhatsApp 连接 — 显示您使用手机扫描的二维码 (WhatsApp的 > 设置 > 连接的设备)
- 选择目标群体 — 选择要发送消息的 WhatsApp 组或联系人
- 在线课程过滤器 — 如果学生有按阅读顺序显示的在线课程,但没有近距离教学,则可以过滤它们
- 更新 — 邮件发送时间 (默认: 作业 16:02, 晚间时间表 20:03, 周六 17:57)
保存设置 config.json档案。
如果您的 WhatsApp 会话过期,它会自动请求一个新的二维码,无需单独重新安装。
配置
config.json (创建 npm run setup 命令):
{
"whatsapp": {
"targetJid": "123456789@g.us",
"isGroup": true,
"targetName": "Ryhmän nimi"
},
"schedule": {
"homeworkCron": "2 16 * * *",
"eveningCron": "3 20 * * *",
"weeklyCron": "57 17 * * 0",
"timezone": "Europe/Helsinki"
},
"filters": {
"onlineCourses": [
{
"studentFirstName": "Matti",
"startTime": "07:00",
"subjectCodePatterns": ["Ver", "verkko"]
}
]
}
}| 字段 | 描述 |
|---|---|
whatsapp.targetJid | WhatsApp 群组或联络人 JID |
whatsapp.isGroup | true 团体, false 个人接触。 |
schedule.*Cron | 克罗恩·劳塞克(语法) |
filters.onlineCourses 按名称、开始时间和课程代码排序在线课程。 |
使用
Scheduler(自动邮件)
npm run scheduler作为 Systemd 服务(登录时自动启动):
# Kopioi palvelutiedosto
cp parenting-scheduler.service ~/.config/systemd/user/
systemctl --user enable --now parenting-scheduler
# Lokit
journalctl --user -u parenting-scheduler -f触发器(Trigger)
如果您的计算机在 cron 期间已关闭,您可以稍后发送消息:
# Pysäytä scheduler (muuten kaksi WhatsApp-sessiota taistelee samasta auth_storesta)
systemctl --user stop parenting-scheduler
# Lähetä haluamasi viesti(t)
npm run trigger -- homework
npm run trigger -- evening # huomisen aikataulu (= kuin Sun-Thu ilta-cron)
npm run trigger -- evening:today # tämän päivän aikataulu (esim. viikonloppu-paussin jälkeen)
npm run trigger -- weekly
npm run trigger -- homework,evening # pilkulla eroteltuna useita
# Käynnistä scheduler takaisin päälle
systemctl --user start parenting-scheduler触发器运行与cron完全相同的逻辑: homework 利用过去的一天, evening 日语 weekly 明天/下周
MCP服务器(Claude集成)
npm run start若要添加 Claude Desktop 或 Claude Code MCP 设置:
{
"mcpServers": {
"parenting": {
"command": "node",
"args": ["/polku/parenting_mcp/build/index.js"]
}
}
}威尔玛
查看 威尔玛气候需要单独安装和配置:
npm install -g @wilm-ai/wilma-cli
wilma # Ensimmäinen kirjautuminen支持多个 Wilma 配置文件(不同学校/家长) — scheduler 会自动查找所有配置文件中的学生。
技术
文件结构
parenting_mcp/
├── src/
│ ├── index.ts # MCP-palvelin
│ ├── scheduler.ts # Ajastetut WhatsApp-viestit
│ ├── jobs.ts # Jaetut työt (käyttävät scheduler + trigger)
│ ├── trigger.ts # Manuaalinen viestien lähetys (CLI)
│ ├── setup.ts # Interaktiivinen setup
│ ├── whatsapp-auth.ts # WhatsApp QR-skannaus (standalone)
│ ├── services/
│ │ ├── whatsapp.ts # WhatsApp-yhteys (Baileys)
│ │ ├── wilma.ts # Wilma CLI -wrapper
│ │ └── config.ts # Config-palvelu
│ └── tools/ # MCP-työkalut
├── config.json # Asetukset (gitignored)
├── auth_store/ # WhatsApp-sessio (gitignored)
└── package.json使用 WhatsApp 的注意事项
此程序使用非官方的 WhatsApp Web 界面 (百利甜酒不被 Metan/WhatsApp 接受或支持。WhatsApp 使用条款可能会禁止您使用非官方 API,并且以这种方式使用您的帐户可能会导致限制或关闭您的帐户。用户对本程序的使用和可能的后果承担全部责任。
