一个跑在 Cloudflare 免费额度上的自托管笔记工具,原生支持 AI Agent 读写

想起一个朋友问我,有没有不需要买服务器、数据还能自己掌控的笔记工具。最近在 GitHub 上看到一个项目,刚好满足这个需求。
项目叫 EdgeEver,作者 tianma-if。它是一个开源的自托管笔记工作空间,提供经典印象笔记的三栏体验,整个后端跑在 Cloudflare 的 Serverless 架构上,用了 Cloudflare Workers 做计算、D1(基于 SQLite)做存储、R2 做文件存储。

作者表示:很多印象笔记 (Evernote )老用户只需要一个可靠、开放、响应快的个人知识库。但现在的商业笔记应用越来越重,迁移成本高,订阅和附加功能不断叠加。
EdgeEver 想填补这个缺口——熟悉的笔记操作、开放的数据格式、API 和 MCP 支持,加上个人可以操作的自托管部署。

要点
-
完全免费且零维护:个人使用完全落在免费额度内,不需要买 VPS、配 Docker 或折腾 SSL 证书,可存储多达 15 万条笔记和 5 万张图片;图片在上传前,会在 Web 浏览器端自动尝试压缩为 WebP 格式(最长边限制 2560px),通常能减小 50%-90% 的体积。这不仅省空间,还完美避开了云端处理图片的计算额度消耗,是实现长期“零成本”的核心巧思。
-
原生 AI Agent 支持:内置 MCP(Model Context Protocol)端点,只需把 API Token 给 Claude Code、Cursor 等 AI 助手,Agent 就能直接读取、整理和维护笔记(例如自动打标签、归纳灵感或构建知识图谱)。借助 MCP,它还能跟 Notion Database、飞书多维表格联动,把零散笔记沉淀为结构化数据。
-
多设备不限量同步与 PWA 支持:自建 API 彻底摆脱了商业软件对登录设备数量的限制,支持跨端无缝同步;支持通过 PWA(渐进式 Web 应用)安装到桌面或手机主屏幕,获得近似原生 App 的体验。
-
经典三栏布局 + 丰富功能:提供笔记本树、笔记列表和编辑器的经典体验,支持无限制嵌套、富文本编辑、笔记版本历史、批量合并/移动、离线草稿。
-
数据开放可控:笔记存储在标准 SQLite(Cloudflare D1)中,可通过 REST API、OpenAPI、MCP 和 CLI 访问,数据完全属于用户自己。
-
多种迁移路径:提供从 Evernote、Memos、Notion 等平台迁移到 EdgeEver 的官方指南。
部署方式
EdgeEver 提供两种部署路径,作者更推荐用 AI Agent 自动完成。
方式一:AI Agent 自动部署(推荐)
把以下 prompt 复制给 Claude Code、Codex、Antigravity、Cursor 或 Trae 等 AI 编程助手:
❝
Please follow these steps:
Fork the EdgeEver upstream repository: https://github.com/tianma-if/edgeever
Use the forked repository to install and deploy EdgeEver to Cloudflare.
Configure a mechanism for the fork to sync updates from the upstream repository, so it can receive the latest product features periodically or on demand.
部署前,建议先给 AI Agent 配置好 GitHub 和 Cloudflare 的 MCP server 或对应插件,这样 Agent 可以直接 fork 仓库、创建 Cloudflare 资源并完成部署。Agent 的详细部署指引见仓库文档中的 AI Agent Cloudflare Deployment。
需要注意:即使不超出免费额度,Cloudflare R2、D1 和 Workers 在开通或使用时可能仍需绑定 Visa 卡。
方式二:手动部署
手动部署的完整步骤写在文档的 Cloudflare Manual Deployment Guide 中。大致流程是先手动创建 Cloudflare 所需的资源,然后配置 .env.local 文件(需填写 D1 ID、R2 bucket、密码哈希等),最后运行 bun run deploy 完成部署。
体验 Demo
如果暂时不想部署,可以直接访问公开 demo:demo.edgeever.org。需要注意的是,demo 每天会自动重置并恢复示例笔记,不要在里面存放私人内容。
❝