note-mcp-server 2.4.1 → 2.5.0

package/index.js

@@ -12,73 +12,101 @@ import {
 import axios from "axios";
 import FormData from "form-data";
 
+import fs from "node:fs";
+import { parse as parseEnv } from "dotenv";
+
 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」。
  *
  * 設定優先序：
- * 1) NOTES_API_BASE — 完整 API base（含 /api/notes/{socialite}/{key}）
- * 2) notes_url + socialite + key（或 socialite_id，與 key 同義：加密路徑 token）
+ * 1) 專案目錄 (cwd) 的 .env 優先（支援不同專案自由切換）
+ * 2) 全域的 note-mcp-server/.env 作為預設退路
+ *
+ * 變數組合：
+ * A) NOTES_API_BASE — 完整 API base（含 /api/notes/{socialite}/{key}）
+ * B) notes_url + socialite + key（或 socialite_id，與 key 同義：加密路徑 token）
  *
  * 變數名支援常見大小寫（見 resolveNotesApiBase）。
  */
 
+const cwdEnvPath = path.join(process.cwd(), ".env");
+const cwdEnv = fs.existsSync(cwdEnvPath) ? parseEnv(fs.readFileSync(cwdEnvPath)) : {};
+
+const globalEnvPath = path.join(__dirname, ".env");
+const globalEnv = fs.existsSync(globalEnvPath) ? parseEnv(fs.readFileSync(globalEnvPath)) : {};
+
+// 將載入的變數注入 process.env (cwd 優先蓋過 global)
+for (const [k, v] of Object.entries(globalEnv)) {
+  if (process.env[k] === undefined) process.env[k] = v;
+}
+for (const [k, v] of Object.entries(cwdEnv)) {
+  process.env[k] = v; // cwd 總是能覆寫
+}
+
 function stripTrailingSlashes(value) {
   return value.replace(/\/+$/, "");
 }
 
-function firstEnv(...keys) {
-  for (const key of keys) {
-    const raw = process.env[key];
-    if (raw === undefined) {
-      continue;
-    }
-    const trimmed = String(raw).trim();
-    if (trimmed !== "") {
-      return trimmed;
+function extractBase(envObj) {
+  const get = (...keys) => {
+    for (const k of keys) {
+      if (envObj[k] !== undefined && String(envObj[k]).trim() !== "") {
+        return String(envObj[k]).trim();
+      }
     }
-  }
-  return "";
-}
+    return "";
+  };
 
-function resolveNotesApiBase() {
-  const direct = firstEnv("NOTES_API_BASE");
+  const direct = get("NOTES_API_BASE");
   if (direct) {
     return stripTrailingSlashes(direct);
   }
 
-  const notesUrl = stripTrailingSlashes(
-    firstEnv("notes_url", "NOTES_URL")
-  );
-  const socialite = firstEnv("socialite", "SOCIALITE");
-  const encryptedToken = firstEnv(
-    "key",
-    "KEY",
-    "socialite_id",
-    "SOCIALITE_ID"
-  );
+  const notesUrl = stripTrailingSlashes(get("notes_url", "NOTES_URL"));
+  const socialite = get("socialite", "SOCIALITE");
+  const encryptedToken = get("key", "KEY", "socialite_id", "SOCIALITE_ID");
 
   if (notesUrl && socialite && encryptedToken) {
     return `${notesUrl}/api/notes/${socialite}/${encryptedToken}`;
   }
 
+  return null;
+}
+
+function resolveNotesApiBase() {
+  let base = extractBase(cwdEnv);
+  if (base) return base;
+
+  base = extractBase(globalEnv);
+  if (base) return base;
+
+  base = extractBase(process.env);
+  if (base) return base;
+
   throw new Error(
     "note-mcp-server：請在專案目錄建立 .env，設定 notes_url、socialite、key（或 socialite_id），或設定 NOTES_API_BASE。詳見 .env.example。"
   );
 }
 
+function firstEnv(...keys) {
+  for (const key of keys) {
+    if (process.env[key] !== undefined) {
+      const trimmed = String(process.env[key]).trim();
+      if (trimmed !== "") return trimmed;
+    }
+  }
+  return "";
+}
+
 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 (${APP_NAME})`,
-    version: "2.4.1",
+    version: "2.4.2",
   },
   {
     capabilities: {
@@ -164,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(
@@ -199,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"],
@@ -226,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: {
@@ -318,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;
@@ -368,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;
         }
@@ -388,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.1",
+  "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": {