note-mcp-server 2.2.3 → 2.2.5

package/README.md

@@ -105,8 +105,8 @@ socialite_id=eyJpdiI6I…
 
 | 工具 | 說明 |
 |------|------|
-| `list_notes` | GET 列表，支援 `search` 關鍵字及 `limit`（預設 3） |
-| `read_note` | GET 單筆，支援 `c_id` 或 `last` |
+| `list_notes` | GET 列表，支援 `search` / `tag` / `page` / `limit`（預設 10），每筆附 `note_url` |
+| `read_note` | GET 單筆，支援 `c_id` 或 `last`，回傳附 `note_url` |
 | `create_note` | POST 新增，`content` 必填，`title` 可選 |
 | `update_note` | POST 修改，`c_id` 必填，支援 `content`、`title`、`append`、`prepend` |
 | `delete_note` | POST 刪除，`c_id` + `action=delete` |
@@ -115,6 +115,12 @@ socialite_id=eyJpdiI6I…
 
 完整 REST 行為請對你的 API 網址加上 **`/help`** 查官方說明。
 
+前台筆記網址格式：
+
+```text
+{notes_url}/app/notes/content/{c_id}
+```
+
 ---
 
 ## 常見問題

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.3",
+    version: "2.2.4",
   },
   {
     capabilities: {
@@ -109,30 +109,44 @@ function normalizeListPayload(data) {
   return [];
 }
 
+function resolveNotesSiteBase() {
+  const fromEnv = firstEnv("notes_url", "NOTES_URL");
+  if (fromEnv) {
+    return stripTrailingSlashes(fromEnv);
+  }
+
+  // BASE_URL = {site}/api/notes/{socialite}/{token}
+  return stripTrailingSlashes(BASE_URL.replace(/\/api\/notes\/.*$/i, ""));
+}
+
+const NOTES_SITE_BASE = resolveNotesSiteBase();
+
+function buildNoteUrl(cId) {
+  if (cId === undefined || cId === null || String(cId).trim() === "") {
+    return "";
+  }
+  return `${NOTES_SITE_BASE}/app/notes/content/${encodeURIComponent(String(cId))}`;
+}
+
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
     tools: [
       {
         name: "list_notes",
-        description: `列出 ${APP_NAME} 的筆記（GET 列表），支援 search 搜尋與 limit 截斷。`,
+        description: `列出或搜尋 ${APP_NAME} 中的筆記。支援關鍵字、標籤搜尋及分頁（預設每頁 10 筆）。回傳資料會附上 note_url（格式：${NOTES_SITE_BASE}/app/notes/content/{c_id}）。`,
         inputSchema: {
           type: "object",
           properties: {
-            search: {
-              type: "string",
-              description: "搜尋關鍵字（可選）",
-            },
-            limit: {
-              type: "number",
-              description: "最多回傳幾筆（預設 3）",
-              default: 3,
-            },
+            search: { type: "string", description: "搜尋關鍵字（可選）" },
+            tag: { type: "string", description: "搜尋標籤（可選，例如：打卡機）" },
+            page: { type: "number", description: "頁碼（可選，預設 1）" },
+            limit: { type: "number", description: "每頁幾筆（可選，預設 10）" },
           },
         },
       },
       {
         name: "read_note",
-        description: `從 ${APP_NAME} 讀取單筆筆記（GET ?c_id=）。亦可傳 c_id=last 讀取最新一筆。`,
+        description: `從 ${APP_NAME} 讀取單筆筆記（GET ?c_id=）。亦可傳 c_id=last 讀取最新一筆。回傳資料會附上 note_url（格式：${NOTES_SITE_BASE}/app/notes/content/{c_id}）。`,
         inputSchema: {
           type: "object",
           properties: {
@@ -227,15 +241,31 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   try {
     switch (name) {
       case "list_notes": {
-        const limit = Number(args.limit) > 0 ? Number(args.limit) : 3;
         const params = {};
-        if (args.search) {
-          params.search = args.search;
-        }
+        if (args.search) params.search = args.search;
+        if (args.tag) params.tag = args.tag;
+        if (args.page) params.page = args.page;
+        params.limit = args.limit || 10;
+
         const response = await axios.get(BASE_URL, { params });
-        const list = normalizeListPayload(response.data).slice(0, limit);
+        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(list, null, 2) }],
+          content: [
+            { type: "text", text: JSON.stringify(payload, null, 2) },
+          ],
         };
       }
 
@@ -244,8 +274,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const response = await axios.get(BASE_URL, {
           params: { c_id: cId },
         });
+        const payload =
+          response.data && typeof response.data === "object"
+            ? { ...response.data }
+            : response.data;
+        if (payload && typeof payload === "object") {
+          const effectiveCid =
+            payload.c_id !== undefined ? payload.c_id : cId === "last" ? "" : cId;
+          payload.note_url = buildNoteUrl(effectiveCid);
+        }
         return {
-          content: [{ type: "text", text: JSON.stringify(response.data, null, 2) }],
+          content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
         };
       }
 

package/package.json

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