Edi Life OS：自托管生活仪表盘，内置 MCP server 接入 AI 助手

Edi Life OS

一个自托管的统一空间，管理你的专注、习惯、目标、财务和项目——内置 MCP 服务器，让你的 AI 助手与你协同工作。

快速开始 · 导览 · AI / MCP · 部署 · API

我们大多数人的生活分散在待办应用、习惯追踪器、预算表格、番茄钟和笔记应用里——而它们彼此互不相通。Edi Life OS 把这一切放进一个平静、私密的仪表盘，并将你今天所做的小事与你希望人生走向的方向连接起来。

• 一切尽在一处。十个工作区共享同一套设计、同一个登录和同一个数据库。
• 相互关联，而非简单堆砌。习惯推动目标进度，看板卡片会出现在日历中，而概览将这一切汇成一个每日评分。
• 属于你。可运行在任何 PHP + MySQL 主机上，哪怕是廉价的共享主机。无订阅、无追踪、无供应商锁定。
• 为 AI 而生。内置 MCP 服务器让 Claude 及其他助手读取你的仪表盘、规划目标、记录习惯并为你追踪开支。

快速导览

成长 —— 六个生活维度，每个都关联长期目标、SMART 目标、习惯和任务。提供每周、每月和每季度的引导式回顾。	专注 —— 带休息的番茄钟会话、内置专注音效，以及随时间变化的风景。
Habittify —— 每日小习惯、连续打卡记录，以及七天一致性概览。	看板 —— 带标签、优先级、截止日期、清单、评论和附件的看板。

全部十个工作区

日期遵循 Asia/Tehran。天气卡片通过 Open-Meteo 显示格什姆岛；其潮汐数据为模型估算，不可用于导航。

用 AI 与你的 Life OS 对话

Edi Life OS 附带一个可选的 MCP 服务器，在你的仪表盘、目标、任务、习惯、财务和笔记中开放 26 个工具。将它连接到 Claude Desktop、Claude Code 或任何 MCP 客户端，即可用自然语言提问：

“显示我的 LifeOS 仪表盘。”

“创建一个名为 Build a home studio 的 SMART 目标，三个月后到期，并添加 Buy acoustic panels 作为任务。”

“将 Reading 标记为今天已完成。”

“记录一笔 450,000 托曼的餐饮开支，并显示我的余额。”

MCP 服务器仅通过其受令牌保护的 HTTP API 与你的应用通信。它从不接触你的数据库或凭据。设置只需一分钟——请参阅下方的 MCP 服务器。

快速开始

使用 Docker（推荐）

git clone https://github.com/edrisranjbar/lifeos.git && cd lifeos
cp .env.example .env    # set your sign-in and passwords
docker compose up -d

打开 localhost:8080 并登录。MySQL、应用和你的附件各自位于独立的卷中，因此 docker compose up -d --build 在 git pull 后升级不会丢失数据。

在共享主机上

从 最新版本 下载 lifeos-<version>.zip 并将其解压到你的主机 主目录，这样 public_html/ 就成为你的 Web 根目录，而后端则安全地位于其上方。将 config.example.php 复制为 config.php，填入你的 MySQL 详细信息，然后打开你的网站。详情请参阅 部署指南。

本地使用 PHP

你需要 PHP 8.1+（带有 pdo_mysql 和 mbstring）以及 MySQL 8+（或 MariaDB 10.4+）。

git clone https://github.com/edrisranjbar/lifeos.git
cd lifeos
cp config.example.php config.php   # PowerShell: Copy-Item config.example.php config.php

用你的数据库连接信息以及你想要用于登录的用户名和密码编辑 config.php，然后启动服务器：

php -S localhost:8000 -t public_html server.php

打开 localhost:8000 并登录。数据库和数据表会在首次使用时创建。你可以稍后在 设置 中更改登录信息。

重要

config.php 和 .env 包含真实凭据，并已被 gitignore。切勿提交它们。

要求

API 与集成

HTTP API

一个私有的 /api/v1 API 覆盖仪表板、目标、任务、习惯、财务和便签。它使用自己的 bearer token，与你的浏览器登录分开。

php -r "echo bin2hex(random_bytes(32));"

将结果设置为 config.php 中的 api_token（或 LIFEOS_API_TOKEN 环境变量），然后：

curl -H "Authorization: Bearer $LIFEOS_API_TOKEN" https://your-host/api/v1/dashboard

有关端点、负载和错误，请参阅 API 参考。

MCP 服务器

cd mcp
npm ci
cp .env.example .env   # set LIFEOS_BASE_URL and LIFEOS_API_TOKEN
npm start

该服务器通过 stdio 运行；没有托管的 MCP 端点。MCP 指南 列出了每个工具，并展示了 Claude 和 Codex 的客户端配置。

你的数据始终属于你

• 一切都存放在 你的 MySQL 数据库中。习惯使用专用表；其他工作区将 JSON 文档存储在 app_state 中。
• 保存使用修订检查，因此过期的标签页无法静默覆盖较新的更改。API 写入使用事务和行锁。
• 来自旧版仅浏览器版本的数据会导入一次；冲突的副本会作为 legacy_backup_* 记录归档。
• 将数据库、附件文件和你的配置一起备份。

要从旧的 Habittify SQLite 数据库迁移？请参阅 迁移 Habittify。

安全

Edi Life OS 是为 单一所有者 构建的。

• API 令牌授予对所有受支持域的读写访问权限。未实现令牌作用域和应用级速率限制，因此请在托管层设置请求限制。
• 在除 localhost 以外的任何地方使用 HTTPS，并让令牌远离 URL、前端代码、截图和日志。
• 默认情况下，秘密笔记对 API 读取隐藏。秘密标志控制可见性；它不是单独的加密。

项目结构

public_html/          Browser workspaces, shared assets and Apache entry points
lib/                  API domains, response helpers and state transactions
mcp/                  Optional Node.js stdio MCP server
tests/                Timer, API, MySQL and integration checks
docs/                 Guides, plus README screenshots in docs/media
config.example.php    Configuration template (no real credentials)
server.php            Development router and application routing
api.php               HTTP API entry point

使用 PHP、MySQL 和原生 JavaScript 构建——没有前端构建步骤，没有框架。

Dockerfile、docker-compose.yml 和 docker/config.php 使用环境变量中的配置运行应用。

文档

• API 参考 — 身份验证、路由、数据格式和并发
• MCP 指南 — 工具、环境设置和客户端设置
• 部署指南 — Apache、共享主机、备份和迁移
• 开发指南 — 本地检查与一次性集成测试夹具
• 成长工作区 · 债务与债权

许可证

MIT © 2026 Edris Ranjbar。使用它、fork 它并在此基础上构建。

贡献

欢迎提出想法、报告 bug 和提交 pull request。打开一个 issue 来开始交流，并查看开发指南以在本地运行检查。

如果 Edi Life OS 帮助你管理日常，考虑给它一个 ⭐ — 这能帮助其他人发现它。