Edi Life OS：自带 MCP 服务器的自托管生活仪表盘开源

Edi Life OS

一个自托管的空间，承载你的专注力、习惯、目标、财务与项目 — 配备 MCP 服务器，让你的 AI 助手能够与你并肩工作。

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

我们中的大多数人，都在待办应用、习惯追踪器、预算电子表格、番茄钟和笔记应用之间来回切换 — 而它们之间互不通气。Edi Life OS 把这一切收纳于同一个安静、私密的面板之中，并把你今天所做的小事，串联到你希望生活前进的方向上。

• 一切尽在一处。十个工作区共享同一套设计、同一个登录入口和同一份数据库。
• 彼此关联，而非简单堆叠。习惯推动目标进度，看板卡片出现在日历中，而总览则将所有内容汇总为每日得分。
• 完全属于你。可运行于任何 PHP + MySQL 主机，即便是廉价的共享主机也无订阅、无追踪、无供应商锁定。
• 为 AI 而生。内置 MCP 服务器，让 Claude 以及其他助手能够读取你的面板、规划目标、记录习惯和追踪支出。

快速导览

成长 — 六大生活维度，分别关联长期目标、SMART 目标、习惯与任务。支持每周、每月和每季度复盘。	专注 — 带休息的 Pomodoro 会话，内置专注背景音，以及随时间变化的环境画面。
Habittify — 微小的日常习惯、连续打卡记录，以及展示你坚持情况的七日视图。	看板 — 包含标签、优先级、截止日期、清单、评论与附件的看板。

全部十个工作区

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

用 AI 与你的 Life OS 对话

Edi Life OS 内置一个可选的 MCP 服务器，提供横跨面板、目标、任务、习惯、财务与便签的 26 个工具。将其连接到 Claude Desktop、Claude Code 或任何 MCP 客户端，用自然语言提问即可：

「给我看看 LifeOS 面板。」

「创建一个名为『搭建家庭工作室』、三个月内完成的 SMART 目标，并将『购买吸音板』作为一项任务加入。」

「将今天的『阅读』标记为完成。」

「记录一笔 450,000 Toman 的餐饮支出，并显示我的余额。」

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 令牌，与您的浏览器登录相互独立。

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 报告和拉取请求。可以先开一个 issue 开始讨论，并查看 开发指南 在本地运行检查。

如果 Edi Life OS 帮你安排日常生活，欢迎给它一个 ⭐ —— 这能帮助更多人发现它。