EdgeEver

EdgeEver: A self-hosted, Cloudflare-native Evernote alternative.

EdgeEver：基于 Cloudflare 全家桶自托管的开源『印象笔记』。

EdgeEver 是一个开源、自托管、Cloudflare-native 的现代笔记工作区。它保留经典印象笔记的三栏体验，同时提供清晰的数据模型、REST API、OpenAPI schema 和 MCP endpoint。

在线演示

• Demo 地址：https://demo.edgeever.org
• 演示账号：ee-demo
• 演示密码：demo#dZ6Q29Zjfor%

公开演示环境可能会被重置，请不要保存私密内容。

功能

• 三栏布局：笔记本树、笔记列表、主编辑区。
• 无限级嵌套笔记本。
• TipTap 富文本编辑，服务端保存结构化 JSON、Markdown 和纯文本。
• 图片粘贴上传到 R2，D1 保存资源元数据。
• 图片自动压缩，GIF 会尝试转 animated WebP。
• 附件入口，可查看资源列表和总存储占用。
• 多选合并笔记，原笔记软删除，资源关联迁移到新笔记。
• 多选移动笔记，笔记本支持拖拽排序和调整层级。
• PWA 可安装，支持静态应用壳离线打开和自动更新。
• 已有笔记支持离线编辑草稿和本地同步队列。
• 单用户登录，密码使用 PBKDF2-SHA256 hash。
• REST API-first，支持 API Token、OpenAPI 和 MCP。

技术栈

• 前端：Vite、React、Tailwind CSS、TipTap、TanStack Query、Dexie。
• 后端：Cloudflare Workers、Hono。
• 存储：Cloudflare D1、Cloudflare R2。
• 工具链：Bun、Wrangler、TypeScript。

快速开始

安装依赖：

bun install

应用本地 D1 迁移：

bun run db:migrate:local

启动本地开发：

bun run dev

常用检查：

bun run typecheck
bun run build

部署

最简单的方式是点击上方 Deploy to Cloudflare 按钮，根据 Cloudflare 向导完成授权和部署。

如果使用 CLI 部署：

cp .env.local.example .env.local
bunx wrangler d1 create edgeever
bunx wrangler r2 bucket create edgeever-resources
bun run auth:hash -- <你的密码>
bun run deploy

把 D1 创建命令返回的 database_id 和密码 hash 填入本机 .env.local。

目录结构

apps/web       Vite + React 前端
apps/api       Cloudflare Worker + Hono API
packages/shared 共享类型、schema 和内容转换
migrations     D1 数据库迁移
wrangler.toml  Cloudflare Workers 配置

内容格式

EdgeEver 同时保存三种内容形态：

content_json      TipTap/ProseMirror 文档，编辑器权威格式
content_markdown  API、Agent、导入导出使用
content_text      搜索、摘要和索引使用

API 文档

OpenAPI schema：

https://你的域名/api/openapi.json

仓库内文件：docs/openapi.json。

MCP

先在 EdgeEver 左侧 设置 里创建 API Token。给只读 Agent 使用时建议只勾选 read:notebooks、read:memos、read:tags；需要写入、移动、合并或上传附件时再增加对应 write:* scope。

MCP endpoint：

https://你的域名/mcp
Authorization: Bearer <api-token>

当前 MCP 使用 Streamable HTTP / JSON-RPC 入口，支持 initialize、tools/list、tools/call 和 batch request。已暴露的 tools：

search_memos
get_memo
create_memo
update_memo
move_memos
merge_memos
move_notebook
list_notebooks
list_tags

本地 stdio MCP 客户端可通过 bridge 连接远程 EdgeEver：

EDGEEVER_URL=https://你的域名 \
EDGEEVER_TOKEN=<api-token> \
bun run mcp:stdio

也可以复用 CLI profile：

bun run cli -- profile set prod --url https://你的域名 --token <api-token>
bun run mcp:stdio -- --profile prod

Claude Desktop / Cursor / Codex 这类本地客户端可把 command 配成 bun，args 配成仓库内 scripts/edgeever-mcp-stdio.mjs 的绝对路径，并通过环境变量传入 EDGEEVER_URL 和 EDGEEVER_TOKEN。

最小调用示例：

curl https://你的域名/mcp \
  -H "Authorization: Bearer <api-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_memos",
      "arguments": {
        "query": "edgeever",
        "limit": 10
      }
    }
  }'

开发者工具

CLI 不是 EdgeEver 面向 Agent 的主入口，只作为自托管场景下的调试、批处理、备份和迁移工具使用。

EDGEEVER_URL=https://你的域名 \
EDGEEVER_TOKEN=<api-token> \
bun run cli -- search edgeever

也可以保存为本机 profile，配置文件默认写入 ~/.edgeever/config.json：

bun run cli -- profile set prod --url https://你的域名 --token <api-token>
bun run cli -- --profile prod notebooks
bun run cli -- --profile prod search edgeever
bun run cli -- --profile prod export <memo-id> --format markdown --out ./memo.md