affine-mcp-server 2.2.0 → 2.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 A Model Context Protocol (MCP) server for AFFiNE. It exposes AFFiNE workspaces and documents to AI assistants over stdio (default) or HTTP (`/mcp`) and supports both AFFiNE Cloud and self-hosted deployments.
 
-[![Version](https://img.shields.io/badge/version-2.2.0-blue)](https://github.com/dawncr0w/affine-mcp-server/releases)
+[![Version](https://img.shields.io/badge/version-2.3.0-blue)](https://github.com/dawncr0w/affine-mcp-server/releases)
 [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-1.17.2-green)](https://github.com/modelcontextprotocol/typescript-sdk)
 [![CI](https://github.com/dawncr0w/affine-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/dawncr0w/affine-mcp-server/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/license-MIT-yellow)](LICENSE)
@@ -38,7 +38,7 @@ Highlights:
 - Supports AFFiNE Cloud and self-hosted AFFiNE instances
 - Supports stdio and HTTP transports
 - Supports token, cookie, and email/password authentication
-- Exposes 90 canonical MCP tools backed by AFFiNE GraphQL and WebSocket APIs
+- Exposes 94 canonical MCP tools backed by AFFiNE GraphQL and WebSocket APIs
 - Includes semantic page composition, native template instantiation, database intent composition, capability and fidelity reporting, and workspace blueprint helpers
 - Includes Docker images, health probes, and end-to-end test coverage
 
@@ -48,7 +48,7 @@ Scope boundaries:
 - Browser-local workspaces stored only in local storage are not available through AFFiNE server APIs
 - AFFiNE Cloud requires API-token-based access for MCP usage; programmatic email/password sign-in is blocked by Cloudflare
 
-> New in v2.2.0: Added document custom-property tools, `read_doc` LinkedPage reference IDs, and table ordering fixes.
+> New in v2.3.0: Added document and folder sidebar icon tools, plus richer hierarchy detection for inline LinkedPage references and synced-doc embeds.
 
 ## Choose Your Path
 | Goal | Start here |

package/dist/index.js

@@ -15,6 +15,7 @@ import { loginWithPassword } from "./auth.js";
 import { registerAuthTools } from "./tools/auth.js";
 import { registerOrganizeTools } from "./tools/organize.js";
 import { registerPropertyTools } from "./tools/properties.js";
+import { registerIconTools } from "./tools/icons.js";
 import { runCli } from "./cli.js";
 import { startHttpMcpServer } from "./sse.js";
 import { existsSync } from "fs";
@@ -167,6 +168,7 @@ async function buildServer() {
     registerHistoryTools(server, gql, { workspaceId: config.defaultWorkspaceId });
     registerOrganizeTools(server, gql, { workspaceId: config.defaultWorkspaceId });
     registerPropertyTools(server, gql, { workspaceId: config.defaultWorkspaceId });
+    registerIconTools(server, gql, { workspaceId: config.defaultWorkspaceId });
     registerUserTools(server, gql);
     registerUserCRUDTools(server, gql);
     if (config.authMode !== "oauth") {

package/dist/toolSurface.js

@@ -41,7 +41,9 @@ const ALL_TOOLS = [
     "get_capabilities",
     "get_collection",
     "get_doc",
+    "get_doc_icon",
     "get_edgeless_canvas",
+    "get_folder_icon",
     "get_orphan_docs",
     "get_workspace",
     "inspect_template_structure",
@@ -81,8 +83,10 @@ const ALL_TOOLS = [
     "update_collection_rules",
     "update_comment",
     "update_database_row",
+    "update_doc_icon",
     "update_doc_title",
     "update_edgeless_block",
+    "update_folder_icon",
     "update_frame_children",
     "update_profile",
     "update_settings",
@@ -133,7 +137,9 @@ const TOOL_GROUPS = {
     get_capabilities: ["docs", "docs.read", "read"],
     get_collection: ["organize", "organize.collections", "organize.read", "read"],
     get_doc: ["docs", "docs.read", "read"],
+    get_doc_icon: ["docs", "docs.read", "read"],
     get_edgeless_canvas: ["docs", "docs.edgeless", "docs.surface", "docs.read", "read"],
+    get_folder_icon: ["organize", "organize.folders", "organize.read", "experimental", "read"],
     get_orphan_docs: ["docs", "docs.tree", "docs.read", "read"],
     get_workspace: ["workspaces", "workspaces.read", "read"],
     inspect_template_structure: ["docs", "docs.template", "docs.read", "read"],
@@ -173,8 +179,10 @@ const TOOL_GROUPS = {
     update_collection_rules: ["organize", "organize.collections", "organize.write", "write"],
     update_comment: ["comments", "comments.write", "write"],
     update_database_row: ["docs", "docs.database", "docs.write", "write"],
+    update_doc_icon: ["docs", "docs.write", "write"],
     update_doc_title: ["docs", "docs.write", "write"],
     update_edgeless_block: ["docs", "docs.edgeless", "docs.write", "write"],
+    update_folder_icon: ["organize", "organize.folders", "organize.write", "experimental", "write"],
     update_frame_children: ["docs", "docs.edgeless", "docs.write", "write"],
     update_profile: ["users", "users.write", "admin", "write"],
     update_settings: ["users", "users.write", "admin", "write"],
@@ -191,7 +199,9 @@ const READ_ONLY_TOOLS = new Set([
     "get_capabilities",
     "get_collection",
     "get_doc",
+    "get_doc_icon",
     "get_edgeless_canvas",
+    "get_folder_icon",
     "get_orphan_docs",
     "get_workspace",
     "inspect_template_structure",
@@ -228,6 +238,7 @@ const CORE_TOOLS = new Set([
     "find_doc_by_title",
     "get_capabilities",
     "get_doc",
+    "get_doc_icon",
     "get_workspace",
     "list_children",
     "list_docs",
@@ -242,6 +253,7 @@ const CORE_TOOLS = new Set([
     "search_docs",
     "sign_in",
     "update_database_row",
+    "update_doc_icon",
     "update_doc_title",
 ]);
 const AUTHORING_EXCLUDED_GROUPS = new Set([

package/dist/tools/docs.js

@@ -7,6 +7,53 @@ import { parseMarkdownToOperations } from "../markdown/parse.js";
 import { renderBlocksToMarkdown } from "../markdown/render.js";
 import { addOrganizeLinkToFolder } from "./organize.js";
 import { DEFAULT_NOTE_XYWH, DEFAULT_STACK_GAP_HORIZONTAL, DEFAULT_STACK_GAP_VERTICAL, SIDE_TO_NORMALIZED_POSITION, encloseBounds, estimateConnectorLabelXYWH, estimateNoteHeightForMarkdown, formatXywhString, parseXywhString, pickConnectorSides, pickFurthestInDirection, sortByFractionalIndex, stackRelativeTo, } from "../edgeless/layout.js";
+function collectLinkedChildIds(blocks) {
+    const databaseRowIds = new Set();
+    for (const [, raw] of blocks) {
+        if (!(raw instanceof Y.Map))
+            continue;
+        if (raw.get("sys:flavour") !== "affine:database")
+            continue;
+        const rows = raw.get("sys:children");
+        if (rows instanceof Y.Array) {
+            rows.forEach((entry) => {
+                if (typeof entry === "string")
+                    databaseRowIds.add(entry);
+                else if (Array.isArray(entry)) {
+                    for (const child of entry)
+                        if (typeof child === "string")
+                            databaseRowIds.add(child);
+                }
+            });
+        }
+    }
+    const ids = [];
+    for (const [blockId, raw] of blocks) {
+        if (!(raw instanceof Y.Map))
+            continue;
+        const flavour = raw.get("sys:flavour");
+        if (flavour === "affine:embed-linked-doc" || flavour === "affine:embed-synced-doc") {
+            const pid = raw.get("prop:pageId");
+            if (typeof pid === "string" && pid)
+                ids.push(pid);
+        }
+        if (databaseRowIds.has(String(blockId)))
+            continue;
+        const propText = raw.get("prop:text");
+        if (propText instanceof Y.Text) {
+            const delta = propText.toDelta();
+            if (Array.isArray(delta)) {
+                for (const d of delta) {
+                    const reference = d.attributes?.reference;
+                    if (reference?.type === "LinkedPage" && typeof reference.pageId === "string" && reference.pageId) {
+                        ids.push(reference.pageId);
+                    }
+                }
+            }
+        }
+    }
+    return ids;
+}
 const WorkspaceId = z.string().min(1, "workspaceId required");
 const DocId = z.string().min(1, "docId required");
 const MarkdownContent = z.string().min(1, "markdown required");
@@ -4783,13 +4830,8 @@ export function registerDocTools(server, gql, defaults) {
                 Y.applyUpdate(doc, Buffer.from(snap.missing, "base64"));
                 const blocks = doc.getMap("blocks");
                 const kids = [];
-                for (const [, raw] of blocks) {
-                    if (!(raw instanceof Y.Map))
-                        continue;
-                    if (raw.get("sys:flavour") !== "affine:embed-linked-doc")
-                        continue;
-                    const pid = raw.get("prop:pageId");
-                    if (typeof pid === "string" && pid && titleById.has(pid)) {
+                for (const pid of collectLinkedChildIds(blocks)) {
+                    if (titleById.has(pid) && !kids.includes(pid)) {
                         kids.push(pid);
                         allChildren.add(pid);
                     }
@@ -4843,14 +4885,8 @@ export function registerDocTools(server, gql, defaults) {
                 const doc = new Y.Doc();
                 Y.applyUpdate(doc, Buffer.from(snap.missing, "base64"));
                 const blocks = doc.getMap("blocks");
-                for (const [, raw] of blocks) {
-                    if (!(raw instanceof Y.Map))
-                        continue;
-                    if (raw.get("sys:flavour") !== "affine:embed-linked-doc")
-                        continue;
-                    const pageId = raw.get("prop:pageId");
-                    if (typeof pageId === "string" && pageId)
-                        allChildren.add(pageId);
+                for (const pageId of collectLinkedChildIds(blocks)) {
+                    allChildren.add(pageId);
                 }
             }
             const baseUrl = (process.env.AFFINE_BASE_URL || endpoint.replace(/\/graphql\/?$/, "")).replace(/\/$/, "");
@@ -4869,7 +4905,7 @@ export function registerDocTools(server, gql, defaults) {
     };
     server.registerTool("get_orphan_docs", {
         title: "Get Orphan Documents",
-        description: "Find all documents that have no parent (not linked from any other doc via embed_linked_doc). Useful for workspace hygiene. Note: scans all docs — O(n).",
+        description: "Find all documents that have no parent (not linked from any other doc via embed_linked_doc / embed_synced_doc blocks or inline LinkedPage references). Useful for workspace hygiene. Note: scans all docs — O(n).",
         inputSchema: { workspaceId: z.string().optional() },
     }, getOrphanDocsHandler);
     const listChildrenHandler = async (parsed) => {
@@ -4882,11 +4918,15 @@ export function registerDocTools(server, gql, defaults) {
         try {
             await joinWorkspace(socket, workspaceId);
             const titleById = new Map();
+            const workspacePageIds = new Set();
+            let hasWorkspaceMetadata = false;
             const wsSnap = await loadDoc(socket, workspaceId, workspaceId);
             if (wsSnap.missing) {
+                hasWorkspaceMetadata = true;
                 const wsDoc = new Y.Doc();
                 Y.applyUpdate(wsDoc, Buffer.from(wsSnap.missing, "base64"));
                 for (const page of getWorkspacePageEntries(wsDoc.getMap("meta"))) {
+                    workspacePageIds.add(page.id);
                     if (page.title)
                         titleById.set(page.id, page.title);
                 }
@@ -4898,16 +4938,15 @@ export function registerDocTools(server, gql, defaults) {
             Y.applyUpdate(doc, Buffer.from(snap.missing, "base64"));
             const blocks = doc.getMap("blocks");
             const children = [];
-            for (const [, raw] of blocks) {
-                if (!(raw instanceof Y.Map))
+            const seen = new Set();
+            for (const pageId of collectLinkedChildIds(blocks)) {
+                if (hasWorkspaceMetadata && !workspacePageIds.has(pageId))
                     continue;
-                if (raw.get("sys:flavour") !== "affine:embed-linked-doc")
+                if (seen.has(pageId))
                     continue;
-                const pageId = raw.get("prop:pageId");
-                if (typeof pageId === "string" && pageId) {
-                    children.push({ docId: pageId, title: titleById.get(pageId) ?? null,
-                        url: `${(process.env.AFFINE_BASE_URL || endpoint.replace(/\/graphql\/?$/, '')).replace(/\/$/, '')}/workspace/${workspaceId}/${pageId}` });
-                }
+                seen.add(pageId);
+                children.push({ docId: pageId, title: titleById.get(pageId) ?? null,
+                    url: `${(process.env.AFFINE_BASE_URL || endpoint.replace(/\/graphql\/?$/, '')).replace(/\/$/, '')}/workspace/${workspaceId}/${pageId}` });
             }
             return text({ docId: parsed.docId, count: children.length, children });
         }
@@ -4917,7 +4956,7 @@ export function registerDocTools(server, gql, defaults) {
     };
     server.registerTool("list_children", {
         title: "List Document Children",
-        description: "List the direct children of a document in the sidebar (embed_linked_doc blocks). Returns docId, title, and URL for each child.",
+        description: "List the direct children of a document in the sidebar (embed_linked_doc / embed_synced_doc blocks and inline LinkedPage references). Returns docId, title, and URL for each child.",
         inputSchema: {
             workspaceId: z.string().optional(),
             docId: z.string().describe("The parent doc whose children to list."),

package/dist/tools/icons.js

@@ -0,0 +1,125 @@
+import { z } from "zod";
+import { receipt } from "../util/mcp.js";
+import { connectWorkspaceSocket, joinWorkspace, wsUrlFromGraphQLEndpoint, } from "../ws.js";
+import { docIconKey, folderIconKey, getExplorerIcon, normalizeIconInput, setExplorerIcon, } from "../util/explorerIcon.js";
+/**
+ * Zod shape for the `icon` parameter shared by both setters. Accepts an emoji
+ * shorthand string, a full `{type:"emoji",unicode}` / `{type:"icon",name}`
+ * object, or `null` to clear the icon.
+ */
+const iconSchema = z
+    .union([
+    z.string(),
+    z.object({ type: z.literal("emoji"), unicode: z.string() }),
+    z.object({ type: z.literal("icon"), name: z.string() }),
+    z.null(),
+])
+    .describe('Emoji shorthand ("🧪"), a full object ({type:"emoji",unicode:"🧪"} or ' +
+    '{type:"icon",name:"check"}), or null to remove the icon.');
+/**
+ * Registers the explorer-icon tools: set/clear and read the Notion-style
+ * sidebar icon on a document or an organize folder. All four share the
+ * `explorerIcon` sub-doc helper so the storage model lives in one place.
+ */
+export function registerIconTools(server, gql, defaults) {
+    function resolveWorkspaceId(workspaceId) {
+        const resolved = workspaceId || defaults.workspaceId;
+        if (!resolved) {
+            throw new Error("workspaceId is required. Provide it as a parameter or set AFFINE_WORKSPACE_ID.");
+        }
+        return resolved;
+    }
+    async function withSocket(workspaceId, fn) {
+        const wsUrl = wsUrlFromGraphQLEndpoint(gql.endpoint);
+        const socket = await connectWorkspaceSocket(wsUrl, gql.cookie, gql.bearer);
+        try {
+            await joinWorkspace(socket, workspaceId);
+            return await fn(socket);
+        }
+        finally {
+            socket.disconnect();
+        }
+    }
+    // ─── update_doc_icon ────────────────────────────────────────────────────────
+    const updateDocIconHandler = async (parsed) => {
+        const workspaceId = resolveWorkspaceId(parsed.workspaceId);
+        const icon = normalizeIconInput(parsed.icon);
+        const result = await withSocket(workspaceId, (socket) => setExplorerIcon(socket, workspaceId, docIconKey(parsed.docId), icon));
+        return receipt("doc.update_icon", {
+            workspaceId,
+            docId: parsed.docId,
+            icon: result.icon,
+            cleared: result.icon === null,
+        });
+    };
+    server.registerTool("update_doc_icon", {
+        title: "Update Document Icon",
+        description: "Set or clear the sidebar icon (the Notion-style emoji slot) on a document. " +
+            "Pass an emoji string, a full icon object, or null to remove it.",
+        inputSchema: {
+            workspaceId: z.string().optional(),
+            docId: z.string().describe("The document whose icon to update."),
+            icon: iconSchema,
+        },
+    }, updateDocIconHandler);
+    // ─── update_folder_icon ─────────────────────────────────────────────────────
+    const updateFolderIconHandler = async (parsed) => {
+        const workspaceId = resolveWorkspaceId(parsed.workspaceId);
+        const icon = normalizeIconInput(parsed.icon);
+        const result = await withSocket(workspaceId, (socket) => setExplorerIcon(socket, workspaceId, folderIconKey(parsed.folderId), icon));
+        return receipt("folder.update_icon", {
+            workspaceId,
+            folderId: parsed.folderId,
+            icon: result.icon,
+            cleared: result.icon === null,
+        });
+    };
+    server.registerTool("update_folder_icon", {
+        title: "Update Folder Icon",
+        description: "Set or clear the sidebar icon on an organize folder. " +
+            "Pass an emoji string, a full icon object, or null to remove it. Experimental.",
+        inputSchema: {
+            workspaceId: z.string().optional(),
+            folderId: z.string().describe("The organize folder whose icon to update."),
+            icon: iconSchema,
+        },
+    }, updateFolderIconHandler);
+    // ─── get_doc_icon ───────────────────────────────────────────────────────────
+    const getDocIconHandler = async (parsed) => {
+        const workspaceId = resolveWorkspaceId(parsed.workspaceId);
+        const result = await withSocket(workspaceId, (socket) => getExplorerIcon(socket, workspaceId, docIconKey(parsed.docId)));
+        return receipt("doc.get_icon", {
+            workspaceId,
+            docId: parsed.docId,
+            icon: result.icon,
+            hasIcon: result.icon !== null,
+        });
+    };
+    server.registerTool("get_doc_icon", {
+        title: "Get Document Icon",
+        description: "Read the current sidebar icon of a document. Returns null when none is set.",
+        inputSchema: {
+            workspaceId: z.string().optional(),
+            docId: z.string().describe("The document whose icon to read."),
+        },
+    }, getDocIconHandler);
+    // ─── get_folder_icon ────────────────────────────────────────────────────────
+    const getFolderIconHandler = async (parsed) => {
+        const workspaceId = resolveWorkspaceId(parsed.workspaceId);
+        const result = await withSocket(workspaceId, (socket) => getExplorerIcon(socket, workspaceId, folderIconKey(parsed.folderId)));
+        return receipt("folder.get_icon", {
+            workspaceId,
+            folderId: parsed.folderId,
+            icon: result.icon,
+            hasIcon: result.icon !== null,
+        });
+    };
+    server.registerTool("get_folder_icon", {
+        title: "Get Folder Icon",
+        description: "Read the current sidebar icon of an organize folder. Returns null when none is set. Experimental.",
+        inputSchema: {
+            workspaceId: z.string().optional(),
+            folderId: z.string().describe("The organize folder whose icon to read."),
+        },
+    }, getFolderIconHandler);
+}

package/dist/util/explorerIcon.js

@@ -0,0 +1,95 @@
+import * as Y from "yjs";
+import { loadDoc, pushDocUpdate } from "../ws.js";
+/** Build the sub-document guid that holds a workspace's explorer icons. */
+export function explorerIconDocId(workspaceId) {
+    return `db$${workspaceId}$explorerIcon`;
+}
+/** Build the per-entity map key for a document. */
+export function docIconKey(docId) {
+    return `doc:${docId}`;
+}
+/** Build the per-entity map key for an organize folder. */
+export function folderIconKey(folderId) {
+    return `folder:${folderId}`;
+}
+/**
+ * Coerce user input into the stored icon shape (or null to clear).
+ *
+ * - A bare string is treated as an emoji shorthand → `{ type: "emoji", unicode }`.
+ * - A `{ type: "emoji", unicode }` or `{ type: "icon", name }` object is passed
+ *   through after validation. Named-icon `name` values are not validated against
+ *   AFFiNE's fixed icon set — they are written as-is.
+ * - `null` clears the icon.
+ */
+export function normalizeIconInput(input) {
+    if (input === null)
+        return null;
+    if (typeof input === "string") {
+        const unicode = input.trim();
+        if (!unicode)
+            throw new Error("icon emoji string must not be empty.");
+        return { type: "emoji", unicode };
+    }
+    if (input.type === "emoji") {
+        const unicode = input.unicode?.trim();
+        if (!unicode)
+            throw new Error("emoji icon requires a non-empty `unicode`.");
+        return { type: "emoji", unicode };
+    }
+    if (input.type === "icon") {
+        const name = input.name?.trim();
+        if (!name)
+            throw new Error("named icon requires a non-empty `name`.");
+        return { type: "icon", name };
+    }
+    throw new Error(`Unsupported icon type: ${JSON.stringify(input.type)}.`);
+}
+async function loadExplorerIconDoc(socket, workspaceId) {
+    const snap = await loadDoc(socket, workspaceId, explorerIconDocId(workspaceId));
+    const doc = new Y.Doc();
+    if (snap.missing)
+        Y.applyUpdate(doc, Buffer.from(snap.missing, "base64"));
+    return doc;
+}
+function readIcon(doc, key) {
+    const map = doc.share.has(key) ? doc.getMap(key) : null;
+    if (!map || !map.has("icon"))
+        return null;
+    const raw = map.get("icon");
+    if (raw && typeof raw.toJSON === "function") {
+        return raw.toJSON();
+    }
+    return raw ?? null;
+}
+/**
+ * Set or clear the sidebar icon for a single explorer entity.
+ *
+ * Loads the workspace's `explorerIcon` sub-doc, mutates only the target entry,
+ * and pushes the minimal delta. Passing `icon = null` removes the `icon` field
+ * while preserving the entry's `id`.
+ */
+export async function setExplorerIcon(socket, workspaceId, key, icon) {
+    const doc = await loadExplorerIconDoc(socket, workspaceId);
+    const prevSV = Y.encodeStateVector(doc);
+    const map = doc.getMap(key);
+    if (!map.has("id"))
+        map.set("id", key);
+    if (icon === null) {
+        if (map.has("icon"))
+            map.delete("icon");
+    }
+    else {
+        map.set("icon", icon);
+    }
+    const delta = Y.encodeStateAsUpdate(doc, prevSV);
+    await pushDocUpdate(socket, workspaceId, explorerIconDocId(workspaceId), Buffer.from(delta).toString("base64"));
+    return { key, icon };
+}
+/**
+ * Read the current sidebar icon for a single explorer entity.
+ * Returns `null` when no icon is set (or the entry does not exist).
+ */
+export async function getExplorerIcon(socket, workspaceId, key) {
+    const doc = await loadExplorerIconDoc(socket, workspaceId);
+    return { key, icon: readIcon(doc, key) };
+}

package/docs/tool-reference.md

@@ -39,6 +39,8 @@ Use this document as a grouped catalog. For exact schemas, your MCP client shoul
 | `create_folder` | Create a root or nested folder | Experimental |
 | `create_workspace_blueprint` | Create a simple workspace folder blueprint | Good for structured onboarding setups |
 | `rename_folder` | Rename a folder | Experimental |
+| `update_folder_icon` | Set or clear a folder's sidebar icon (emoji or named icon) | Experimental |
+| `get_folder_icon` | Read a folder's current sidebar icon | Experimental |
 | `delete_folder` | Delete a folder recursively | Experimental and destructive |
 | `move_organize_node` | Move a folder or link node | Experimental |
 | `add_organize_link` | Add a doc, tag, or collection link under a folder | Experimental |
@@ -83,6 +85,8 @@ Use this document as a grouped catalog. For exact schemas, your MCP client shoul
 | Tool | Purpose | Notes |
 | --- | --- | --- |
 | `update_doc_title` | Rename a document in workspace metadata and in the page block | |
+| `update_doc_icon` | Set or clear a document's sidebar icon (emoji or named icon) | |
+| `get_doc_icon` | Read a document's current sidebar icon | |
 | `append_block` | Append canonical block types with validation and placement control | Supports text, media, embeds, database, and edgeless blocks. `frame`/`edgeless_text`/`note` accept `x`/`y`/`width`/`height`. `note` with `text` auto-creates a child paragraph so it renders on the edgeless canvas. |
 | `create_semantic_page` | Create an AFFiNE-native page with an intentional section skeleton and native block composition | High-level authoring helper |
 | `append_semantic_section` | Append a semantic section to an existing page by heading title | High-level authoring helper |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "affine-mcp-server",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "private": false,
   "type": "module",
   "description": "Model Context Protocol server for AFFiNE - enables AI assistants to interact with AFFiNE workspaces, documents, and collaboration features.",
@@ -49,6 +49,7 @@
     "test:data-view": "node tests/test-data-view.mjs",
     "test:doc-discovery": "node tests/test-doc-discovery.mjs",
     "test:doc-properties": "node tests/test-doc-properties.mjs",
+    "test:icons": "node tests/test-icons.mjs",
     "test:read-doc-linked-refs": "node tests/test-read-doc-linked-refs.mjs",
     "test:find-doc-by-title": "node tests/test-find-doc-by-title.mjs",
     "test:create-placement": "node tests/test-create-placement.mjs",

package/tool-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.2.0",
+  "version": "2.3.0",
   "tools": [
     "add_database_column",
     "add_database_row",
@@ -43,7 +43,9 @@
     "get_capabilities",
     "get_collection",
     "get_doc",
+    "get_doc_icon",
     "get_edgeless_canvas",
+    "get_folder_icon",
     "get_orphan_docs",
     "get_workspace",
     "inspect_template_structure",
@@ -83,8 +85,10 @@
     "update_collection_rules",
     "update_comment",
     "update_database_row",
+    "update_doc_icon",
     "update_doc_title",
     "update_edgeless_block",
+    "update_folder_icon",
     "update_frame_children",
     "update_profile",
     "update_settings",