智能任务推荐应用

Flowzen是一款基于神经科学的智能任务推荐应用,通过分析用户能量状态和时间,提供个性化的任务建议,帮助用户高效管理时间。

  • by deng-diana
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 deng-diana/flowzen-mcp

使用说明

Flowzen

用你的大脑工作。不反对。

Flowzen是Claude内部的MCP应用程序。它知道你的任务、时间和你的感受,并给你一个明确的答案: 现在就这么做。背后的科学原因。

Todoist会给你一个列表。Flowzen给你一个答案。

现在试试克劳德: 添加 https://flowzen-mcp-dfdb5406.alpic.live/mcp 作为Claude设置中的远程MCP服务器。需要Pro、Team、Max或Enterprise帐户。


问题

每天你打开任务清单,盯着它看,然后关闭它。

这不是拖延。这就是决策疲劳——这也是你最重要的工作没有完成的原因。

你的大脑有能量节律:高峰、低谷、恢复期。其他所有生产力工具都忽略了这一点。他们给你一份清单,让你去弄清楚剩下的。

Flowzen填补了这一空白。


Flowzen做什么

告诉Flowzen你需要做什么以及你的感受。它给你 一个答案 --不是一个排序的列表,也不是一个优先级矩阵——这是现在要做的一项任务,其原因源于神经科学。

  • 上午10点,精力充沛? → 你的皮质醇正在达到峰值。这是你最锋利的窗户。用它来完成你最艰巨的任务。
  • 下午2点,撞车? → 这是生物学,不是弱点。仅限轻度任务——你的第二个高峰大约在下午3点左右。
  • 刚做完什么? → 你已经康复了。这就是持续绩效的实际运作方式。

特性

  • 智能任务推荐 --一项任务,与你的能量状态和一天中的时间相匹配
  • 神经科学推理 --基于昼夜节律研究的温暖、人性化的理论基础
  • 全面任务管理 --通过聊天或小部件添加、完成、删除任务
  • 能量状态选择器 --四种具有时间感知默认值的状态
  • 复苏助推 --完工后的休息建议
  • 对话捕捉 --在克劳德聊天中自然提及任务;Flowzen捕捉到了它们

技术栈

层 技术
框架 天桥 MCP应用程序
后端 Node.js/TypeScript
前端 React小部件
数据库 Supabase(Postgres+RLS)
Auth Alpic上的公共模式(无OAuth)或通过Alpic网关的保护模式
主机 Alpic

本地开发

先决条件

  • Node.js v24.13+
  • pnpm-- npm install -g pnpm
  • Supabase命令行界面-- brew install supabase/tap/supabase
  • Supabase项目 suabase.com/dashboard

设置

1.安装依赖项

pnpm i

2.配置环境变量

cp .env.example .env

填写您的密钥:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
# Optional
# ANTHROPIC_API_KEY=...
# MCP_SERVER_URL=https://your-public-base-url

3.链接Supabase并推送迁移

supabase link
supabase db push

4.启动开发服务器

pnpm dev

Skybridge开发工具可在 http://localhost:3000.

5.连接到克劳德(可选)

cloudflared tunnel --url http://localhost:3000

添加 https://<tunnel>.trycloudflare.com/mcp 在Claude设置中作为远程MCP服务器。


项目结构

server/src/
  index.ts        ← Express app setup (do not modify)
  middleware.ts   ← MCP transport wiring (do not modify)
  supabase.ts     ← DB operations (do not modify)
  server.ts       ← MCP tool, recommendation engine, neuroscience logic

web/src/
  widgets/
    flowzen.tsx   ← Main widget UI
  index.css       ← All styles (no Tailwind, no CSS modules)
  helpers.ts      ← Skybridge hooks
  components/     ← Types, AddTaskForm, LoadingScreen

supabase/
  migrations/     ← Database schema migrations

数据库模式

tasks 表:

列 类型 注释
id uuid 主键
user_id text 逻辑用户ID
title text 任务名称
priority 文本 "low"
difficulty 文本 "easy"
completed bool 完成标志
due_date 日期 可选
created_at timestamp 自动设置

RLS已启用。所有查询都使用按以下条件筛选的服务角色键 user_id.


Supabase命令

supabase link                    # Link to remote project (once)
supabase db push                 # Apply migrations to remote DB
supabase db reset --linked       # Reset remote DB (destructive)
supabase migration new <name>    # Create a new migration

部署到生产

git add <files>
git commit -m "your message"
git push origin main

在这个回购中,推 main 触发Alpic自动部署。然后使用部署的URL /mcp 在Claude设置中附加为远程MCP服务器。

部署后,运行:

BASE_URL=https://flowzen-mcp-dfdb5406.alpic.live pnpm probe:prod

此检查在以下时间初始化 / 和 /mcp,并打印OAuth端点状态。


Alpic上的OAuth(重要)

开 公共 Alpic部署、OAuth发现和授权路由经常返回 404 从公共边缘。这是意料之中的。

  • 公共模式焦点:可到达的MCP端点(/ 或 /mcp)
  • 保护模式焦点:在Alpic中配置身份验证提供者;OAuth路由由Alpic网关处理

因此,如果MCP初始化正常,但OAuth路由正常 404,您的应用程序在公共模式下仍然可以正常运行。


路线图

  • 谷歌日历同步——围绕推荐自动阻止时间
  • 苹果健康能源数据——用生物识别信号取代手动情绪输入
  • 语音登记——通过语音“我感觉很好,我应该处理什么?”
  • 团队模式——在共享任务列表中协调焦点窗口

哲学

大多数生产力工具都是为机器设计的。恒定输出。没有摩擦。没有人性。

Flowzen是为人类设计的。

我们的目标不是做得更多。 这是对你所做的事情感觉良好。


资源