核心用法
ofw-mcp是OurFamilyWizard平台的非官方MCP服务器,提供对共育数据的程序化访问。支持Claude Code直接集成或mcporter代理模式。配置需提供OFW账号凭证,通过环境变量或配置文件注入。
主要功能覆盖四大模块:
- 消息系统:完整支持收件箱/发件箱/草稿箱管理,支持附件上传下载、线程回复、草稿预览机制
- 日历:事件CRUD操作,支持ISO 8601日期格式
- 费用管理:创建费用记录、查询余额汇总
- 日记功能:条目创建与分页查询
关键设计采用本地缓存策略:ofw_sync_messages需优先调用以同步数据;读取未读消息会触发"已读"状态变更,系统会提示用户确认。
显著优点
1. 双向读写能力:区别于只读集成,支持主动发送消息、创建事件、记录费用
2. 法律场景适配:草稿预览机制(ofw_save_draft→用户确认→ofw_send_message)避免冲动发送
3. 线程化对话:replyToId参数自动附加原始消息历史,符合共育沟通的证据链需求
4. 缓存优化:本地消息缓存减少API调用,ofw_list_messages支持日期范围和关键词搜索
潜在缺点与局限性
1. 凭证安全风险:密码明文存储于环境变量,无OAuth或令牌轮换机制
2. 非官方集成:依赖逆向工程,OFW API变更可能导致功能中断
3. 读取副作用:ofw_get_notifications和ofw_get_message会修改服务器状态(last-seen/已读标记),无纯读取模式
4. 附件管理限制:上传文件需先写入"My Files"再引用,无直接消息附件流
5. 单账户架构:不支持多账户切换,需为不同共育关系部署独立实例
适合人群
- 高冲突共育家庭:需严格记录沟通、监控对方已读状态的家长
- 法律从业者:协助客户导出证据、准备庭审材料的家庭法律师
- 共育协调员:批量管理多个家庭的日程与费用分摊
- 自动化需求者:需定期同步日历、费用提醒的API用户
常规风险
- 证据链污染风险:误操作"已读"标记或自动发送可能损害法律立场
- 隐私泄露:共育数据含敏感家庭信息,本地缓存文件需加密保护
- 服务中断:非官方性质无SLA保障,关键日期前需手动验证同步
- 账户封禁:违反OFW服务条款的自动化使用可能导致账户限制