note-mcp-server 2.3.1 → 2.3.3

package/index.js

@@ -14,8 +14,10 @@ import FormData from "form-data";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
+// 優先載入專案目錄 (cwd) 的 .env，以支援不同專案自由切換
+loadEnv({ path: path.join(process.cwd(), ".env") });
+// 如果專案目錄沒有設定，則退回讀取全域的 .env
 loadEnv({ path: path.join(__dirname, ".env") });
-
 /**
  * MCP 須由 Cursor 依 mcp.json 啟動；勿在終端機手動跑本檔當成「掛載 MCP」。
  *
@@ -76,7 +78,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.3.0",
+    version: "2.3.3",
   },
   {
     capabilities: {
@@ -172,14 +174,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 +193,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: "追加在開頭的內容（可選）" },
           },
@@ -350,6 +369,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.3.1",
+  "version": "2.3.3",
   "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": {