note-mcp-server 2.2.9 → 2.3.2

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: {
@@ -172,14 +172,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       {
         name: "create_note",
         description: withSecurityNotice(
-          `在 ${APP_NAME} 中新增筆記。內容請優先使用簡潔的 AdminLTE 4 card 結構。`
+          `在 ${APP_NAME} 中新增筆記。內容請優先使用簡潔的 AdminLTE 4 card 結構。\nAI 行為：除非用戶明確要求，否則不要傳 tags（勿自行推測、分類或補加標籤）。`
         ),
         inputSchema: {
           type: "object",
           properties: {
             content: { type: "string", description: "HTML 或純文字內容" },
             title: { type: "string", description: "標題（可選）" },
-            tags: { type: "string", description: "標籤，多個標籤以逗號分隔（可選）" },
+            tags: {
+              type: "string",
+              description:
+                "標籤，多個以逗號分隔（可選；僅當用戶明確要求設定標籤時才傳，勿主動填寫）",
+            },
           },
           required: ["content"],
         },
@@ -187,15 +191,28 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       {
         name: "update_note",
         description: withSecurityNotice(
-          `在 ${APP_NAME} 中修改筆記。內容請優先使用簡潔的 AdminLTE 4 card 結構，避免嵌套破版，支援以 append/prepend 追加內容。`
+          `在 ${APP_NAME} 中修改筆記。內容請優先使用簡潔的 AdminLTE 4 card 結構，避免嵌套破版，支援以 append/prepend 追加內容。\nAI 行為：除非用戶明確要求，否則不要傳 tags、add_tags（勿自行推測或補加標籤）；亦不要傳 title，除非用戶明確要求變更標題。\n標籤語意：tags＝整包覆寫既有標籤；add_tags＝在既有標籤上追加（逗號分隔），勿刪除未提及的標籤。用戶只要「多加幾個標籤」時請用 add_tags，勿用 tags。`
         ),
         inputSchema: {
           type: "object",
           properties: {
             c_id: { type: "number", description: "筆記 ID" },
             content: { type: "string", description: "新內容（可選，若未傳則使用現有內容作為基底）" },
-            title: { type: "string", description: "新標題（可選）" },
-            tags: { type: "string", description: "新標籤，多個標籤以逗號分隔（可選）" },
+            title: {
+              type: "string",
+              description:
+                "新標題（可選；僅當用戶明確要求變更標題時才傳，勿為「優化」或推測而擅自改標題）",
+            },
+            tags: {
+              type: "string",
+              description:
+                "新標籤，多個以逗號分隔（可選；僅當用戶明確要求「整包重設」標籤時才傳，會覆寫既有全部標籤；勿主動填寫）",
+            },
+            add_tags: {
+              type: "string",
+              description:
+                "僅追加標籤，多個以逗號分隔（可選；與既有標籤合併、不覆寫未列出的標籤。僅當用戶明確要求「在現有標籤上多加」時才傳；勿主動填寫）",
+            },
             append: { type: "string", description: "追加在結尾的內容（可選）" },
             prepend: { type: "string", description: "追加在開頭的內容（可選）" },
           },
@@ -229,7 +246,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",
@@ -350,6 +367,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (args.tags !== undefined) {
           payload.tags = args.tags;
         }
+        if (args.add_tags !== undefined && args.add_tags !== "") {
+          payload.add_tags = args.add_tags;
+        }
         if (args.append !== undefined) {
           payload.append = args.append;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "note-mcp-server",
-  "version": "2.2.9",
+  "version": "2.3.2",
   "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": {