note-mcp-server 2.2.6 → 2.2.9

package/README.md

@@ -110,6 +110,7 @@ socialite_id=eyJpdiI6I…
 | `create_note` | POST 新增，`content` 必填，`title` 可選 |
 | `update_note` | POST 修改，`c_id` 必填，支援 `content`、`title`、`append`、`prepend` |
 | `delete_note` | POST 刪除，`c_id` + `action=delete` |
+| `tag` | GET 搜尋，根據標籤名稱找出筆記內容 |
 | `upload_image` | multipart，`image_base64`、可選 `filename` |
 | `send_push` | POST 推播，`message` 必填，`title` / `url` 可選 |
 

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.4",
+    version: "2.2.8",
   },
   {
     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: "追加在開頭的內容（可選）" },
           },
@@ -211,6 +213,19 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ["c_id"],
         },
       },
+      {
+        name: "tag",
+        description: withSecurityNotice(
+          "根據標籤搜尋筆記內容。例如：tag 待辨。"
+        ),
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: { type: "string", description: "標籤名稱，例如：待辨" },
+          },
+          required: ["name"],
+        },
+      },
       {
         name: "upload_image",
         description: withSecurityNotice(
@@ -309,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" },
         });
@@ -329,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;
         }
@@ -357,6 +378,32 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           ],
         };
       }
+      case "tag": {
+        const params = {
+          tag: args.name,
+          limit: args.limit || 10,
+        };
+        const response = await axios.get(BASE_URL, { params });
+        const payload =
+          response.data && typeof response.data === "object"
+            ? { ...response.data }
+            : response.data;
+
+        const notes = normalizeListPayload(payload);
+        if (Array.isArray(notes)) {
+          for (const note of notes) {
+            if (note && typeof note === "object" && note.c_id !== undefined) {
+              note.note_url = buildNoteUrl(note.c_id);
+            }
+          }
+        }
+
+        return {
+          content: [
+            { type: "text", text: JSON.stringify(payload, null, 2) },
+          ],
+        };
+      }
 
       case "upload_image": {
         let b64 = String(args.image_base64).replace(/\s/g, "");

package/package.json

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