note-mcp-server 2.2.8 → 2.3.1

package/index.js

@@ -76,7 +76,7 @@ const APP_NAME = firstEnv("app_name", "APP_NAME", "notes_app_name", "NOTES_APP_N
 const server = new Server(
   {
     name: `note-mcp-server (${APP_NAME})`,
-    version: "2.2.8",
+    version: "2.3.0",
   },
   {
     capabilities: {
@@ -179,6 +179,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           properties: {
             content: { type: "string", description: "HTML 或純文字內容" },
             title: { type: "string", description: "標題（可選）" },
+            tags: { type: "string", description: "標籤，多個標籤以逗號分隔（可選）" },
           },
           required: ["content"],
         },
@@ -194,6 +195,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             c_id: { type: "number", description: "筆記 ID" },
             content: { type: "string", description: "新內容（可選，若未傳則使用現有內容作為基底）" },
             title: { type: "string", description: "新標題（可選）" },
+            tags: { type: "string", description: "新標籤，多個標籤以逗號分隔（可選）" },
             append: { type: "string", description: "追加在結尾的內容（可選）" },
             prepend: { type: "string", description: "追加在開頭的內容（可選）" },
           },
@@ -227,7 +229,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       {
         name: "upload_image",
         description: withSecurityNotice(
-          `將圖片上傳至 ${APP_NAME}。此工具會回傳圖片的永久網址（URL）。若用戶要求生成圖片及內容，請務必分兩步執行：1. 先呼叫此工具傳圖獲取網址；2. 將獲取的網址以 <img> 標籤補進筆記內容（create_note 或 update_note）中。`
+          `將圖片上傳至 ${APP_NAME}。此工具會回傳圖片的永久網址（URL）。若用戶要求生成圖片及內容，請務必分兩步執行：1. 先呼叫此工具傳圖獲取網址；2. 將獲取的網址以 <img> 標籤補進筆記內容（create_note 或 update_note）中。\n⚠️ 極度重要：如果圖檔為本機實體檔案且體積較大，直接透過本工具傳遞 Base64 極易因終端機輸出字數限制而被截斷，導致上傳損壞的圖片（破圖）且 API 不會報錯。\n✅ AI 最佳實踐：若遇到大圖或本地實體圖，請優先去讀取本 MCP 伺服器目錄下的 .env 以取得 \`notes_url\`, \`socialite\`, \`key\`，然後「直接使用原生的 curl -X POST」發送 multipart/form-data (image=@路徑) 到 API，完全繞過 MCP 工具的限制！`
         ),
         inputSchema: {
           type: "object",
@@ -322,6 +324,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (args.title !== undefined && args.title !== "") {
           payload.title = args.title;
         }
+        if (args.tags !== undefined && args.tags !== "") {
+          payload.tags = args.tags;
+        }
         const response = await axios.post(BASE_URL, payload, {
           headers: { "Content-Type": "application/json" },
         });
@@ -342,6 +347,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (args.title !== undefined) {
           payload.title = args.title;
         }
+        if (args.tags !== undefined) {
+          payload.tags = args.tags;
+        }
         if (args.append !== undefined) {
           payload.append = args.append;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "note-mcp-server",
-  "version": "2.2.8",
+  "version": "2.3.1",
   "description": "MCP (stdio) server for Notes API v2 — list/read/write notes, upload images, Web Push from Cursor and compatible clients.",
   "main": "index.js",
   "bin": {