note-mcp-server 2.4.2 → 2.5.0

package/index.js

@@ -192,6 +192,16 @@ function buildNoteUrl(cId) {
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
     tools: [
+      {
+        name: "block_list",
+        description: withSecurityNotice(
+          `列出 ${APP_NAME} 中當前用戶有權限建立內容的所有區塊（看板/筆記本等）。回傳的資料會包含每個區塊的名稱與可用的狀態標籤 (tags)。如果該區塊有設定狀態標籤（例如用於 Kanban 或是 Defect Flow），請在安排工作流程或建立內容時參考這些可用的標籤；若無狀態標籤，則通常為單純的 CMS 或企業知識庫，直接新增內容即可。回傳的 b_id 可用於 create_note 建立內容到指定看板。`
+        ),
+        inputSchema: {
+          type: "object",
+          properties: {},
+        },
+      },
       {
         name: "list_notes",
         description: withSecurityNotice(
@@ -227,18 +237,19 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         name: "create_note",
         description: withCardGuide(
           withSecurityNotice(
-            `在 ${APP_NAME} 中新增筆記。內容請優先使用 AdminLTE 4 可摺疊 card（見下方結構）。\nAI 行為：除非用戶明確要求，否則不要傳 tags（勿自行推測、分類或補加標籤）。`
+            `在 ${APP_NAME} 中新增筆記。未指定任何 b_id 的情況下，代表就是新增至「我的筆記」預設值。內容請優先使用 AdminLTE 4 可摺疊 card（見下方結構）。\nAI 行為：\n1. 除非用戶明確要求，否則不要傳 tags（勿自行推測、分類或補加標籤）。\n2. 若用戶僅提供區塊名稱（例如「看板」）而未提供 b_id，請先呼叫 block_list 查詢。若只有一個相符的名稱，直接使用該 b_id 建立；若有多個相符名稱，請列出選項並詢問用戶要加到哪一個 b_id。`
           )
         ),
         inputSchema: {
           type: "object",
           properties: {
+            b_id: { type: "number", description: "指定要建立的區塊 ID（可選，預設為個人筆記本）。可先用 block_list 查詢可用的 b_id" },
             content: { type: "string", description: "HTML 或純文字內容" },
             title: { type: "string", description: "標題（可選）" },
             tags: {
               type: "string",
               description:
-                "標籤，多個以逗號分隔（可選；僅當用戶明確要求設定標籤時才傳，勿主動填寫）",
+                "標籤，多個以逗號分隔（可選；若指定 b_id 且該區塊有必填標籤時，不傳則會自動補上預設狀態標籤）",
             },
           },
           required: ["content"],
@@ -254,6 +265,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         inputSchema: {
           type: "object",
           properties: {
+            b_id: { type: "number", description: "移動到指定的區塊 ID（可選）" },
             c_id: { type: "number", description: "筆記 ID" },
             content: { type: "string", description: "新內容（可選，若未傳則使用現有內容作為基底）" },
             title: {
@@ -346,6 +358,21 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
   try {
     switch (name) {
+      case "block_list": {
+        const response = await axios.get(BASE_URL, {
+          params: { action: "list_blocks" },
+        });
+        const payload =
+          response.data && typeof response.data === "object"
+            ? { ...response.data }
+            : response.data;
+        return {
+          content: [
+            { type: "text", text: JSON.stringify(payload, null, 2) },
+          ],
+        };
+      }
+
       case "list_notes": {
         const params = {};
         if (args.search) params.search = args.search;
@@ -396,6 +423,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
       case "create_note": {
         const payload = { content: args.content };
+        if (args.b_id !== undefined && args.b_id !== null) {
+          payload.b_id = Number(args.b_id);
+        }
         if (args.title !== undefined && args.title !== "") {
           payload.title = args.title;
         }
@@ -416,6 +446,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const payload = {
           c_id: Number(args.c_id),
         };
+        if (args.b_id !== undefined && args.b_id !== null) {
+          payload.b_id = Number(args.b_id);
+        }
         if (args.content !== undefined) {
           payload.content = args.content;
         }

package/package.json

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