外包技能测试（Ofw Skill Test）

ofw-mcp 是 OurFamilyWizard 的 MCP 服务器，提供对消息、日历、费用和日记的读写访问。 npm：npmjs.com/package/ofw-mcp 源码：github.com/chrischall/ofw-mcp

设置选项 A — Claude Code（直接 MCP，无 mcporter） 在项目的 .mcp.json 或 ~/.claude/mcp.json 中添加：

{
  "mcpServers": {
    "ofw": {
      "command": "npx",
      "args": ["-y", "ofw-mcp"],
      "env": {
        "OFW_USERNAME": "you@example.com",
        "OFW_PASSWORD": "yourpassword"
      }
    }
  }
}

设置选项 B — mcporter

• 安装：npm install -g ofw-mcp 或从源码安装：git clone https://github.com/chrischall/ofw-mcp，然后 cd ofw-mcp，npm install && npm run build
• 配置凭据：cp .env.example .env，编辑 .env 文件，设置 OFW_USERNAME 和 OFW_PASSWORD
• 注册 mcporter：mcporter config add ofw --command "ofw-mcp" --env "OFW_USERNAME=you@example.com" --env "OFW_PASSWORD=yourpassword" --config ~/.mcporter/mcporter.json
• 验证：mcporter list --config ~/.mcporter/mcporter.json，mcporter call ofw.ofw_get_profile --config ~/.mcporter/mcporter.json

调用工具（mcporter）：mcporter call ofw. [key=value ...] --config ~/.mcporter/mcporter.json 始终传递 --config ~/.mcporter/mcporter.json，除非本地存在 config/mcporter.json 文件。

工具 用户工具 描述 ofw_get_profile 获取当前用户和共同父母的信息（ID、联系方式） ofw_get_notifications 获取仪表盘摘要：未读消息数、即将发生的事件、未付费用。更新最后查看状态。

消息工具 备注 ofw_list_message_folders 获取文件夹 ID（收件箱、已发送等）- 首先调用此方法 ofw_list_messages(folderId) 列出文件夹中的消息 ofw_get_message(messageId) 读取一条消息。标记未读消息为已读。 ofw_send_message(subject, body, recipientIds[], replyToId?, draftId?) 发送一条消息。传递 replyToId 以线程原始消息历史（如电子邮件回复）。传递 draftId 以在发送后自动删除草稿。 ofw_list_drafts 列出保存的草稿 ofw_save_draft(subject, body, recipientIds?, messageId?, replyToId?) 创建或更新草稿 ofw_delete_draft(messageId) 删除草稿

日历工具 备注 ofw_list_events(startDate, endDate, detailed?) 日期格式为 YYYY-MM-DD ofw_create_event(title, startDate, endDate, ...) startDate/endDate 格式为 ISO 日期时间 ofw_update_event(eventId, ...) 部分更新 - 只传递要更改的字段 ofw_delete_event(eventId) 永久删除

费用工具 备注 ofw_get_expense_totals 获取总计 ofw_list_expenses(start?, max?) 分页；默认最大 20 ofw_create_expense(amount, description) 记录一项新费用

日记工具 备注 ofw_list_journal_entries(start?, max?) 1 基础偏移；默认最大 10 ofw_create_journal_entry(title, body) 创建一条新日记

工作流程 检查收件箱：ofw_list_message_folders → 查找收件箱文件夹 ID ofw_list_messages(folderId) → 列出消息 ofw_get_message(messageId) → 读取一条特定消息 发送消息：ofw_get_profile → 获取共同父母的用户 ID ofw_send_message(subject, body, [coParentId]) 回复一条消息（带有线程历史）：ofw_get_message(messageId) → 读取要回复的消息 ofw_send_message(subject, body, [coParentId], replyToId: messageId) - 原始消息包含在线程中 草稿发送（敏感消息）：ofw_save_draft(subject, body) → 审核 ofw_send_message(..., draftId) 在批准后发送 - 草稿在发送后自动删除 检查即将发生的事件：ofw_get_notifications 快速摘要 ofw_list_events(today, +30days) 日历详细信息

警告 始终在发送消息或删除任何内容之前确认 - OFW 是一个法律共同父母记录。 ofw_get_notifications 更新最后查看状态 - 避免在后台静默调用。 ofw_get_message 标记消息为已读 - 如果用户想要保持某些内容为未读，请警告用户。