About Easyaccounts
Easyaccounts is an MCP server published by QingHeYang in the Developer Tools category: 中文家庭及个人适用的记账软件 使用AI记账、AI分析数据.
The repository has 363 stars and 34 forks, with the last commit 4 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/QingHeYang/EasyAccountsThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Easyaccounts
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 4 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
1 check has not been run yet.
Releases
README
简介
EasyAccounts 是一款开源中文记账软件，支持本地 Docker 部署，数据完全自主可控。
新版本集成 AI 智能助手，可以通过对话查询、新增、修改流水，还能生成你想要的 Excel 报表。
如果你对互联网上的记账 App 不放心，担心信息泄露或数据丢失，也许这个项目能满足你的需求。
快速了解
| 项目 | 说明 |
|---|---|
| 👤 面向受众 | 个人 / 家庭 (不支持团队) |
| 🐳 部署要求 | 会使用 Docker Compose |
| 💻 支持平台 | Linux · Windows · macOS · 飞牛Fnos |
| 📦 资源消耗 | 内存 500-800MB |
核心特点
| 功能 | 说明 |
|---|---|
| 📝 记账管理 | 账户 · 收支操作 · 二级分类 · 明细流水 |
| 🔍 数据筛选 | 时间 · 账户 · 分类 · 备注 |
| 📊 报表生成 | 月度账单 · 筛选报表 · Excel 导出 · 自动月度 Excel |
| 🤖 AI 助手 | 对话记账 · 智能查询 · 图片识别 · MCP (SSE / Streamable-HTTP) |
| ⏰ 定时记账 | 周期账单自动生成（日 / 周 / 月 / 年）· 执行历史可查 |
| 📧 消息推送 | SQL 备份 · Excel 邮件推送 · 站内通知中心 |
| 🔐 安全特性 | 登录认证 · 单点登录 · 数据自主可控 |
项目部署
git clone https://github.com/QingHeYang/EasyAccounts.git
cd EasyAccounts
docker compose up -d
启动后访问 http://你的IP:10669
版本动态
v2.7.0
重要特性
- 新增 定时记账：周期性账单（订阅、房贷、水电、工资等）按规则自动生成流水，支持每日 / 每周 / 每月 / 每年，可暂停、修改、查执行历史
- 新增 自动月度 Excel：每月按时自动生成账单 Excel，可邮件发送，无需手动导出
- 新增 站内通知中心：双端顶栏铃铛 + 未读徽章，定时记账、Excel 生成等通知统一收口
- 新增 统计页日支出折线图 + 明细页日合计
- 设置全面 UI 化：邮件 SMTP、备份时间、登录方式、自动 Excel 全部在前端「系统设置」配置，改完立即生效，无需重启容器
- AI 操作失败时前端会显示具体原因，不再静默卡住
重要变更
- ⚠️ WebHook 容器已废弃，邮件能力内置到 server。老用户升级请删除
docker-compose.yml中webhook:服务块及SMTP_*等环境变量，在前端「系统设置 → 邮件」重新配置
完整说明：v2.7.0 更新日志
v2.6.2
- 新增 OpenClaw Skills 集成（独立 Skill，无需升级容器）
下一版计划
我思路比较跳脱，很多情况下不会按照计划来
- 账单导入（目前可通过 OpenClaw Skills 批量导入，原生入口规划中）
- 多账本
- 自定义筛选条件保存
功能预览
查看更多截图：功能展示
功能说明
记账基础
记账围绕四个维度：账户、收支操作、分类、明细
- 账户：你的钱放在哪，比如现金、银行卡、支付宝
- 收支操作：钱怎么动的，收入、支出、借入、借出、内部转账（默认已配好，够用）
- 分类：钱花在哪，支持二级分类，比如「用车」下面可以有「加油」「保险」
- 明细：每一笔流水记录
记一笔账：选账户 → 选操作 → 选分类 → 填金额 → 保存，搞定。
AI 助手
接入大模型 API，支持：
- 对话记账：「昨天午饭花了 25」
- 智能查询：「这个月花了多少」
- 图片识别：拍个小票自动识别
- MCP 功能：支持 SSE / Streamable-HTTP 协议
需要自己配置 API Key，支持多家大模型。
报表导出
两种 Excel 报表：
- 月度账单：在明细页面生成当月账单
- 筛选账单：按条件筛选后导出
小提示：生成历史月份账单时，账户余额会追溯到当时的金额
数据备份
- SQL 自动备份：在前端「系统设置 → 备份」配置备份时间，备份文件在
Resource/sql/ - 页面恢复数据：直接在前端选择 SQL 备份文件即可恢复，无需手动映射
- 邮件推送：在前端「系统设置 → 邮件」配置 SMTP，SQL 备份和 Excel 自动发到邮箱
v2.7.0 起，原 WebHook 容器已废弃，邮件能力内置到 server，所有配置改在前端 UI 完成，改完立即生效，无需重启。
开发者友好
- Swagger 接口文档：方便二次开发
- Nginx 文件服务：直接下载生成的文件
详见：项目访问地址
写在最后
这个项目从 2021 年 9 月开始，到现在已经 5 年多了。
我是个旧时代的 Android 工程师，从 2024 年开始大量用 AI 辅助开发（ChatGPT、Copilot、Cursor、Claude...），所以代码注释可能有点糙，请多包涵。
重要提醒：一定要保护好 SQL 备份数据，bug 可以修，项目可以重部署，但数据丢了就真没办法了。
这个项目会一直维护下去，因为我自己天天在用。有好点子随时告诉我，合适的话我会加上。
欢迎 Star，遇到问题欢迎提 Issue。项目永久免费开源。
另外我是个社恐，加微信、拉群这种事可能会有点迟疑，不是不想理你，是真的社恐，请多包涵。
关于贡献：目前新版本还在调试中，源码仓库暂时落后于发布版本，想参与贡献的朋友请耐心等待。
交流群
欢迎加入 QQ 群交流：817098590
支持项目
如果你愿意支持 EasyAccounts，扫码捐赠的款项我会以 EasyAccounts 项目名义转赠至腾讯公益孤儿救助项目。
README fetched from the repository 4 days ago. The original is authoritative.