note-mcp-server 1.0.0 → 2.1.0

package/README.md

@@ -105,10 +105,10 @@ socialite_id=eyJpdiI6I…
 
 | 工具 | 說明 |
 |------|------|
-| `list_notes` | GET 列表，可選 `limit`（預設 3） |
-| `read_note` | GET 單筆，`c_id` |
+| `list_notes` | GET 列表，支援 `search` 關鍵字及 `limit`（預設 3） |
+| `read_note` | GET 單筆，支援 `c_id` 或 `last` |
 | `create_note` | POST 新增，`content` 必填，`title` 可選 |
-| `update_note` | POST 修改，`c_id`、`content` 必填，`title` 可選 |
+| `update_note` | POST 修改，`c_id` 必填，支援 `content`、`title`、`append`、`prepend` |
 | `delete_note` | POST 刪除，`c_id` + `action=delete` |
 | `upload_image` | multipart，`image_base64`、可選 `filename` |
 | `send_push` | POST 推播，`message` 必填，`title` / `url` 可選 |

package/index.js

@@ -71,11 +71,12 @@ function resolveNotesApiBase() {
 }
 
 const BASE_URL = resolveNotesApiBase();
+const APP_NAME = firstEnv("app_name", "APP_NAME", "notes_app_name", "NOTES_APP_NAME") || "Personal Note Assistant";
 
 const server = new Server(
   {
-    name: "note-mcp-server",
-    version: "1.0.0",
+    name: `note-mcp-server (${APP_NAME})`,
+    version: "2.1.0",
   },
   {
     capabilities: {
@@ -113,10 +114,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     tools: [
       {
         name: "list_notes",
-        description: "列出筆記（GET 列表），可依 limit 截斷前 N 筆。",
+        description: `列出 ${APP_NAME} 的筆記（GET 列表），支援 search 搜尋與 limit 截斷。`,
         inputSchema: {
           type: "object",
           properties: {
+            search: {
+              type: "string",
+              description: "搜尋關鍵字（可選）",
+            },
             limit: {
               type: "number",
               description: "最多回傳幾筆（預設 3）",
@@ -127,13 +132,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "read_note",
-        description: "讀取單筆筆記（GET ?c_id=）。",
+        description: `從 ${APP_NAME} 讀取單筆筆記（GET ?c_id=）。亦可傳 c_id=last 讀取最新一筆。`,
         inputSchema: {
           type: "object",
           properties: {
             c_id: {
-              type: "number",
-              description: "筆記 ID（c_id）",
+              type: "string",
+              description: "筆記 ID（c_id）或 'last'",
             },
           },
           required: ["c_id"],
@@ -154,15 +159,17 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "update_note",
-        description: "修改筆記（POST：c_id、title、content）。",
+        description: `在 ${APP_NAME} 中修改筆記（POST：c_id、title、content）。亦支援 append/prepend 追加內容。`,
         inputSchema: {
           type: "object",
           properties: {
             c_id: { type: "number", description: "筆記 ID" },
-            content: { type: "string", description: "新內容" },
+            content: { type: "string", description: "新內容（可選，若未傳則使用現有內容作為基底）" },
             title: { type: "string", description: "新標題（可選）" },
+            append: { type: "string", description: "追加在結尾的內容（可選）" },
+            prepend: { type: "string", description: "追加在開頭的內容（可選）" },
           },
-          required: ["c_id", "content"],
+          required: ["c_id"],
         },
       },
       {
@@ -220,7 +227,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     switch (name) {
       case "list_notes": {
         const limit = Number(args.limit) > 0 ? Number(args.limit) : 3;
-        const response = await axios.get(BASE_URL);
+        const params = {};
+        if (args.search) {
+          params.search = args.search;
+        }
+        const response = await axios.get(BASE_URL, { params });
         const list = normalizeListPayload(response.data).slice(0, limit);
         return {
           content: [{ type: "text", text: JSON.stringify(list, null, 2) }],
@@ -228,7 +239,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       }
 
       case "read_note": {
-        const cId = Number(args.c_id);
+        const cId = args.c_id;
         const response = await axios.get(BASE_URL, {
           params: { c_id: cId },
         });
@@ -255,11 +266,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case "update_note": {
         const payload = {
           c_id: Number(args.c_id),
-          content: args.content,
         };
+        if (args.content !== undefined) {
+          payload.content = args.content;
+        }
         if (args.title !== undefined) {
           payload.title = args.title;
         }
+        if (args.append !== undefined) {
+          payload.append = args.append;
+        }
+        if (args.prepend !== undefined) {
+          payload.prepend = args.prepend;
+        }
         const response = await axios.post(BASE_URL, payload, {
           headers: { "Content-Type": "application/json" },
         });

package/package.json

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