ofw MCP

我们的家庭向导MCP

A. 模型上下文协议 将Claude连接到的服务器 我们的家庭巫师，让你用自然语言访问你的共同育儿信息、日历、开支和日记。

\[！警告\] AI开发项目。 此代码库完全由以下人员构建并积极维护 克劳德·十四行诗4.6.没有人审核执行情况。使用前检查所有代码和工具权限。

你能做什么

问克劳德这样的问题：

• *“显示我最近的OFW消息”*
• *“下周孩子们的日历上有什么？”*
• *“列出最近的开支，告诉我我欠了什么”*
• *“添加有关今天取件的日记条目”*
• *“起草对我共同父母最后一条消息的回复”*

需求

• 克劳德桌面版
• 18岁或以后
• 一个活跃的OurFamilyWizard帐户

安装

1.克隆和构建

git clone https://github.com/chrischall/ofw-mcp.git
cd ofw-mcp
npm install
npm run build

2.添加到克劳德桌面

编辑您的Claude Desktop配置文件：

• 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

添加 ofw 进入里面 "mcpServers" （如果密钥不存在，则创建密钥）：

{
  "mcpServers": {
    "ofw": {
      "command": "node",
      "args": ["/absolute/path/to/ofw-mcp/dist/index.js"],
      "env": {
        "OFW_USERNAME": "your-email@example.com",
        "OFW_PASSWORD": "your-ofw-password"
      }
    }
  }
}

替换 /absolute/path/to/ofw-mcp 使用克隆仓库的实际路径。在Mac上，运行 pwd 在克隆的目录中获取它。

3.重新启动克劳德桌面

完全退出（Mac上的Cmd+Q，而不仅仅是关闭窗口）并重新启动。

4.验证

问克劳德： *“我的OFW仪表板是什么样子的？”* --它应该显示您的未读邮件数、即将发生的事件和未付费用。

凭证

凭据是从环境变量中读取的，有两种方法可以提供它们：

选项A——Claude Desktop配置中的env块 （如上所示，推荐）：

"env": {
  "OFW_USERNAME": "your-email@example.com",
  "OFW_PASSWORD": "your-ofw-password"
}

选项B-- .env 文件 在项目目录中：

cp .env.example .env
# edit .env and fill in your credentials

环境变量始终优先于 .env 文件。您也可以直接在命令行上传递它们：

OFW_USERNAME=you@example.com OFW_PASSWORD=yourpass node dist/index.js

可用工具

只读工具会自动运行。书写工具首先要求您确认。

故障排除

“0封邮件” --Claude可能已经读取了通知计数，而不是实际的消息。明确提问： *“列出我的OFW收件箱中的邮件”* 或 *“先使用w_list_message_folder，然后使用w_list_messages”*.

“必须设置OFW_USERNAME和OFW_PASSWORD” --缺少凭据。检查 env 在Claude Desktop配置或 .env 文件。

403禁止 --错误的凭证。在以下网址验证您的用户名/密码 我们的家庭巫师网.

工具未出现在Claude中 首选 克劳德桌面版→ 设置→ 开发者 查看连接的服务器和任何错误输出。确保在编辑配置后完全退出并重新启动。

在Mac上找不到配置文件 --在Finder中按Cmd+Shift+G并粘贴 ~/Library/Application Support/Claude/.

安全

• 凭据仅存在于您的本地配置文件中，或 .env
• 它们作为环境变量传递给服务器，从不记录
• 服务器使用与web应用程序相同的登录流向OFW进行身份验证
• 使用强大、唯一的OFW密码

发展

npm test        # run the test suite
npm run build   # compile TypeScript → dist/

项目结构

src/
  client.ts       OFW auth and HTTP client
  index.ts        MCP server entry point
  tools/
    user.ts       ofw_get_profile, ofw_get_notifications
    messages.ts   folders, list, get, send
    calendar.ts   list, create, update, delete events
    expenses.ts   totals, list, create
    journal.ts    list, create entries
tests/
  client.test.ts
  tools/

认证流程

OFW使用Spring Security表单登录：

1. GET /ofw/login.form --建立会话cookie
2. POST /ofw/login --提交凭据，返回 { auth: "" }
3. 所有API调用都使用 Authorization: Bearer
4. 在401上，自动重新进行身份验证并重试一次

令牌缓存6小时。

许可证

麻省理工学院