Skip to content

AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.

Add MCP notebook creation tool

tianmaa8f50b4ee415
diff --git a/README.md b/README.md
index 791d3f37..f6c5aebf 100644
--- a/README.md
+++ b/README.md
@@ -150,7 +150,7 @@ stdio MCP 示例:
- `command` 需要本机已安装 Bun。
- `args` 改成你本机 EdgeEver 仓库里的绝对路径。
- `EDGEEVER_TOKEN` 来自 EdgeEver 左侧 **设置**。
-- 只读 Agent 建议 scopes:`read:notebooks`、`read:memos`、`read:tags`;需要写入再加 `write:memos`。
+- 只读 Agent 建议 scopes:`read:notebooks`、`read:memos`、`read:tags`;需要写入笔记再加 `write:memos`,需要创建或移动笔记本再加 `write:notebooks`。
## 开发者工具
diff --git a/apps/api/src/index.ts b/apps/api/src/index.ts
index c41c6561..29c31484 100644
--- a/apps/api/src/index.ts
+++ b/apps/api/src/index.ts
@@ -22,6 +22,7 @@ import {
type MemoRevision,
type MemoSummary,
type Notebook,
+ type NotebookCreateInput,
type Resource,
type ResourceListItem,
type ResourceStorageSummary,
@@ -465,20 +466,17 @@ app.post("/api/v1/notebooks", zValidator("json", NotebookCreateSchema), async (c
const input = c.req.valid("json");
const actor = getAuditActor(c);
- const id = createId("nb");
- const now = isoNow();
-
- await c.env.DB.prepare(
- `INSERT INTO notebooks (id, parent_id, name, slug, sort_order, created_at, updated_at)
- VALUES (?, ?, ?, ?, ?, ?, ?)`
- )
- .bind(id, input.parentId ?? null, input.name, slugify(input.name), Date.now(), now, now)
- .run();
- const notebook = await getNotebook(c.env.DB, id);
- await audit(c.env.DB, actor.actorType, actor.actorId, "notebook.create", "notebook", id, { name: input.name });
+ try {
+ const notebook = await createNotebookRecord(c.env.DB, input, actor);
+ return c.json({ notebook }, 201);
+ } catch (error) {
+ if (error instanceof AppError) {
+ return apiError(c, error.code, error.message, error.status);
+ }
- return c.json({ notebook }, 201);
+ throw error;
+ }
});
app.patch("/api/v1/notebooks/:id", zValidator("json", NotebookUpdateSchema), async (c) => {
@@ -1844,6 +1842,20 @@ const MCP_TOOLS = [
},
},
},
+ {
+ name: "create_notebook",
+ description: "Create a notebook at the root or under another notebook.",
+ inputSchema: {
+ type: "object",
+ required: ["name"],
+ additionalProperties: false,
+ properties: {
+ name: { type: "string", minLength: 1, maxLength: 80 },
+ parentId: { type: ["string", "null"] },
+ sortOrder: { type: "integer" },
+ },
+ },
+ },
{
name: "list_notebooks",
description: "List active notebooks.",
@@ -2014,6 +2026,27 @@ const callMcpTool = async (
return { notebook };
}
+ case "create_notebook": {
+ assertScope(auth, "write:notebooks");
+ const actor = getAuditActor(c);
+ const name = getRequiredString(args.name, "name");
+
+ if (name.length > 80) {
+ throw new AppError("invalid_params", "name must be at most 80 characters", 400);
+ }
+
+ const notebook = await createNotebookRecord(
+ c.env.DB,
+ {
+ name,
+ parentId: args.parentId === null ? null : getOptionalString(args.parentId) ?? undefined,
+ sortOrder: typeof args.sortOrder === "number" && Number.isInteger(args.sortOrder) ? args.sortOrder : undefined,
+ },
+ actor
+ );
+
+ return { notebook };
+ }
case "list_notebooks": {
assertScope(auth, "read:notebooks");
return { notebooks: await listNotebooks(c.env.DB) };
@@ -2783,6 +2816,44 @@ const getNotebook = async (db: D1Database, id: string): Promise<Notebook | null>
return row ? mapNotebook(row) : null;
};
+const createNotebookRecord = async (
+ db: D1Database,
+ input: NotebookCreateInput & { sortOrder?: number },
+ actor: { actorType: "user" | "agent"; actorId: string | null }
+) => {
+ const parentId = input.parentId ?? null;
+
+ if (parentId && !(await getNotebook(db, parentId))) {
+ throw new AppError("not_found", "Parent notebook not found", 404);
+ }
+
+ const id = createId("nb");
+ const now = isoNow();
+ const sortOrder = input.sortOrder ?? Date.now();
+
+ await db.batch([
+ db
+ .prepare(
+ `INSERT INTO notebooks (id, parent_id, name, slug, sort_order, created_at, updated_at)
+ VALUES (?, ?, ?, ?, ?, ?, ?)`
+ )
+ .bind(id, parentId, input.name, slugify(input.name), sortOrder, now, now),
+ auditStatement(db, actor.actorType, actor.actorId, "notebook.create", "notebook", id, {
+ name: input.name,
+ parentId,
+ sortOrder,
+ }),
+ ]);
+
+ const notebook = await getNotebook(db, id);
+
+ if (!notebook) {
+ throw new AppError("not_found", "Notebook not found after create", 404);
+ }
+
+ return notebook;
+};
+
const updateNotebookRecord = async (
db: D1Database,
id: string,