triliumnext-mcp 0.3.13 → 0.3.14

package/README.md

@@ -14,73 +14,120 @@ Make sure to set up your environment variables first:
 
 ## Installation
 
-### 1. Using with Claude Desktop
 
-Add the server config to your Claude Desktop configuration file:
+Below are the installation guide for this MCP on different MCP clients, such as Claude Desktop, Claude Code, Cursor, Cline, etc.
 
-#### For Local Installation (on Windows)
+<details>
+<summary>Claude Desktop</summary>
+
+Add to your Claude Desktop configuration:
 
 ```json
-"triliumnext-mcp": {
-  "command": "cmd",
-  "args": [
-        "/k",
-        "npx",
-        "-y",
-        "triliumnext-mcp"
-      ],
-   "env": {
-    "TRILIUM_API_URL": "http://localhost:8080/etapi",
-    "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>",
-    "PERMISSIONS": "READ;WRITE"
+{
+  "mcpServers": {
+    "triliumnext-mcp": {
+      "command": "npx",
+      "args": ["triliumnext-mcp"],
+      "env": {
+        "TRILIUM_API_URL": "http://localhost:8080/etapi",
+        "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>",
+        "PERMISSIONS": "READ;WRITE"
+      }
+    }
   }
 }
 ```
+</details>
+
+<details>
+<summary>Claude Code</summary>
+
+```bash
+claude mcp add triliumnext-mcp \
+  -e TRILIUM_API_URL=http://localhost:8080/etapi \
+  -e TRILIUM_API_TOKEN=<YOUR_TRILIUM_API_TOKEN> \
+  -e PERMISSIONS='READ;WRITE' \
+  -- npx triliumnext-mcp
+```
 
-#### For Local installation (on Linux)
+Note: Increase the MCP startup timeout to 1 minutes and MCP tool execution timeout to about 5 minutes by updating `~\.claude\settings.json` as follows:
 
 ```json
-"triliumnext-mcp": {
-  "command": "npx",
-  "args": [
-        "-y",
-        "triliumnext-mcp"
-      ],
-   "env": {
-    "TRILIUM_API_URL": "http://localhost:8080/etapi",
-    "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>",
-    "PERMISSIONS": "READ;WRITE"
+{
+  "env": {
+    "MCP_TIMEOUT": "60000",
+    "MCP_TOOL_TIMEOUT": "300000"
   }
 }
 ```
 
-#### For Development (on Windows / Linux)
+</details>
 
-```bash
-cd /path/to/triliumnext-mcp
-npm run build
+<details>
+<summary>Cursor</summary>
+
+Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server
+
+Pasting the following configuration into your Cursor ~/.cursor/mcp.json file is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See [Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol) for more info.
+
+```json
+{
+  "mcpServers": {
+    "triliumnext-mcp": {
+      "command": "npx",
+      "args": ["triliumnext-mcp"],
+      "env": {
+        "TRILIUM_API_URL": "http://localhost:8080/etapi",
+        "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>",
+        "PERMISSIONS": "READ;WRITE"
+      }
+    }
+  }
+}
 ```
+</details>
+
+
+<details>
+<summary>Cline</summary>
+
+Cline uses a JSON configuration file to manage MCP servers. To integrate the provided MCP server configuration:
+
+1. Open Cline and click on the MCP Servers icon in the top navigation bar.
+2. Select the Installed tab, then click Advanced MCP Settings.
+3. In the cline_mcp_settings.json file, add the following configuration:
 
+(i) Using Google AI Studio Provider
 ```json
-"triliumnext-mcp": {
-  "command": "node",
-  "args": [
-        "/path/to/triliumnext-mcp/build/index.js"
-  ],
-  "env": {
-    "TRILIUM_API_URL": "http://localhost:8080/etapi",
-    "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>",
-    "PERMISSIONS": "READ;WRITE",
-    "VERBOSE": "true"
+{
+  "mcpServers": {
+    "timeout": 300, 
+    "type": "stdio",
+    "triliumnext-mcp": {
+      "command": "npx",
+      "args": ["triliumnext-mcp"],
+      "env": {
+        "TRILIUM_API_URL": "http://localhost:8080/etapi",
+        "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>",
+        "PERMISSIONS": "READ;WRITE"
+      }
+    }
   }
 }
 ```
+</details>
+
+
+<details>
 
-Location of the configuration file:
-- Windows: `%APPDATA%/Claude/claude_desktop_config.json`
-- MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+<summary>Other MCP clients</summary>
 
-**Feedback**: Please report issues and test results at [GitHub Issues](https://github.com/TriliumNext/Notes/issues)
+The server uses stdio transport and follows the standard MCP protocol. It can be integrated with any MCP-compatible client by running:
+
+```bash
+npx triliumnext-mcp
+```
+</details>
 
 ## Available Tools
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triliumnext-mcp",
-  "version": "0.3.13",
+  "version": "0.3.14",
   "description": "A model context protocol server for TriliumNext Notes",
   "type": "module",
   "bin": {
@@ -21,13 +21,14 @@
     "inspector": "npx @modelcontextprotocol/inspector build/index.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "0.6.0",
+    "@modelcontextprotocol/sdk": "^1.25.2",
     "axios": "^1.8.3",
-    "marked": "^16.3.0"
+    "marked": "^16.3.0",
+    "mime-db": "^1.54.0"
   },
   "devDependencies": {
     "@types/node": "^20.11.24",
     "typescript": "^5.3.3",
     "zod": "^3.24.1"
   }
-}
+}

package/build/index.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export { buildNoteParams } from './modules/utils/formatting/noteBuilder.js';
-//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA0JA,OAAO,EACL,eAAe,EAChB,MAAM,2CAA2C,CAAC"}

package/build/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/modules/attributes/attributeListHandler.d.ts

@@ -1,14 +0,0 @@
-/**
- * Attribute List Handler Module
- * Centralized request handling for attribute listing operations
- */
-/**
- * Handle list_attributes tool requests
- */
-export declare function handleListAttributesRequest(args: any, axiosInstance: any, permissionChecker: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-}>;
-//# sourceMappingURL=attributeListHandler.d.ts.map

package/build/modules/attributes/attributeListHandler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attributeListHandler.d.ts","sourceRoot":"","sources":["../../../src/modules/attributes/attributeListHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG;;;;;GA0BtG"}

package/build/modules/attributes/attributeListHandler.js

@@ -1,35 +0,0 @@
-/**
- * Attribute List Handler Module
- * Centralized request handling for attribute listing operations
- */
-import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
-import { handleListAttributes } from "./operations/attributeList.js";
-/**
- * Handle list_attributes tool requests
- */
-export async function handleListAttributesRequest(args, axiosInstance, permissionChecker) {
-    if (!permissionChecker.hasPermission("READ")) {
-        throw new McpError(ErrorCode.InvalidRequest, "Permission denied: Not authorized to list attributes.");
-    }
-    try {
-        const listOperation = {
-            noteId: args.noteId,
-            hierarchyLevel: args.hierarchyLevel || 'immediate',
-            limit: args.limit || 50
-        };
-        const result = await handleListAttributes(listOperation, axiosInstance);
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify(result, null, 2)
-                }]
-        };
-    }
-    catch (error) {
-        if (error instanceof McpError) {
-            throw error;
-        }
-        throw new McpError(ErrorCode.InvalidParams, error instanceof Error ? error.message : String(error));
-    }
-}
-//# sourceMappingURL=attributeListHandler.js.map

package/build/modules/attributes/attributeListHandler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"attributeListHandler.js","sourceRoot":"","sources":["../../../src/modules/attributes/attributeListHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,IAAS,EAAE,aAAkB,EAAE,iBAAsB;IACrG,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,uDAAuD,CAAC,CAAC;IACxG,CAAC;IAED,IAAI,CAAC;QACH,MAAM,aAAa,GAAG;YACpB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,WAAW;YAClD,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;SACxB,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAExE,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC,CAAC;SACH,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtG,CAAC;AACH,CAAC"}

package/build/modules/attributes/attributeManageHandler.d.ts

@@ -1,16 +0,0 @@
-/**
- * Attribute Manage Handler Module
- * Processes MCP requests for attribute management operations
- */
-import { AxiosInstance } from 'axios';
-import { PermissionChecker } from '../shared/index.js';
-import { ManageAttributesRequest } from '../shared/index.js';
-/**
- * Handle manage_attributes MCP request
- */
-export declare function handleManageAttributes(args: ManageAttributesRequest, axiosInstance: AxiosInstance, permissionChecker: PermissionChecker): Promise<any>;
-/**
- * Get help text for attribute management
- */
-export declare function get_manage_attributes_help(): string;
-//# sourceMappingURL=attributeManageHandler.d.ts.map

package/build/modules/attributes/attributeManageHandler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attributeManageHandler.d.ts","sourceRoot":"","sources":["../../../src/modules/attributes/attributeManageHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,uBAAuB,EAC7B,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC,GAAG,CAAC,CA6Fd;AA0HD;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAsDnD"}

package/build/modules/attributes/attributeManageHandler.js

@@ -1,261 +0,0 @@
-/**
- * Attribute Manage Handler Module
- * Processes MCP requests for attribute management operations
- */
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
-import { manage_attributes } from './attributeManageManager.js';
-import { format_attributes_for_display } from '../shared/index.js';
-/**
- * Handle manage_attributes MCP request
- */
-export async function handleManageAttributes(args, axiosInstance, permissionChecker) {
-    try {
-        // Validate required parameters
-        if (!args.noteId) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "❌ Missing required parameter: noteId"
-                    }
-                ],
-                isError: true
-            };
-        }
-        if (!args.operation) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "❌ Missing required parameter: operation"
-                    }
-                ],
-                isError: true
-            };
-        }
-        // Check WRITE permission for all manage_attributes operations
-        if (!permissionChecker.hasPermission("WRITE")) {
-            throw new McpError(ErrorCode.InvalidRequest, "Permission denied: Not authorized to manage attributes.");
-        }
-        // Validate operation
-        const validOperations = ["create", "update", "delete", "batch_create"];
-        if (!validOperations.includes(args.operation)) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `❌ Invalid operation: ${args.operation}. Valid operations are: ${validOperations.join(", ")}`
-                    }
-                ],
-                isError: true
-            };
-        }
-        // Validate attributes for write operations
-        if (!args.attributes || !Array.isArray(args.attributes) || args.attributes.length === 0) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "❌ Missing or invalid required parameter: attributes (must be a non-empty array for write operations)"
-                    }
-                ],
-                isError: true
-            };
-        }
-        // For single operations, ensure only one attribute
-        if (["create", "update", "delete"].includes(args.operation) && args.attributes.length !== 1) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `❌ Operation '${args.operation}' requires exactly one attribute, but ${args.attributes.length} were provided`
-                    }
-                ],
-                isError: true
-            };
-        }
-        // Execute the attribute operation
-        const params = {
-            noteId: args.noteId,
-            operation: args.operation,
-            attributes: args.attributes
-        };
-        const result = await manage_attributes(params, axiosInstance);
-        return format_attribute_response(result, args.noteId, args.operation);
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ Attribute operation failed: ${error instanceof Error ? error.message : 'Unknown error'}`
-                }
-            ],
-            isError: true
-        };
-    }
-}
-/**
- * Format attribute operation result for MCP response
- */
-function format_attribute_response(result, noteId, operation) {
-    const content = [];
-    // Add status message
-    if (result.success) {
-        content.push({
-            type: "text",
-            text: `✅ ${result.message}`
-        });
-    }
-    else {
-        content.push({
-            type: "text",
-            text: `❌ ${result.message}`
-        });
-        // Add error details if available
-        if (result.errors && result.errors.length > 0) {
-            content.push({
-                type: "text",
-                text: `📋 Error details:\n${result.errors.map((err, i) => `${i + 1}. ${err}`).join('\n')}`
-            });
-        }
-        // Add specific guidance for common errors
-        if (result.errors && result.errors.some((err) => err.includes("already exists"))) {
-            content.push({
-                type: "text",
-                text: `💡 **Attribute Already Exists**
-
-The attribute you're trying to create already exists on this note. Here are your options:
-
-1. **Update the existing attribute** (recommended):
-   - Use operation: "update" instead of "create"
-   - Only the value and position can be updated for labels
-   - Only the position can be updated for relations
-
-2. **Delete and recreate** (for inheritable changes):
-   - First delete with operation: "delete"
-   - Then recreate with operation: "create"
-   - Use this when you need to change the 'isInheritable' property
-
-3. **View current attributes**:
-   - Use read_attributes to see all existing attributes
-   - Check current values, positions, and inheritable settings
-
-📋 **Example update operation**:
-\`\`\`
-{
-  "noteId": "${noteId}",
-  "operation": "update",
-  "attributes": [{"type": "label", "name": "your_attribute", "value": "new_value"}]
-}
-\`\`\``
-            });
-        }
-    }
-    // Add attribute data for successful operations
-    if (result.success && result.attributes && result.attributes.length > 0) {
-        content.push({
-            type: "text",
-            text: format_attributes_for_display(result.attributes)
-        });
-        // For batch operations, add summary
-        if (operation === "batch_create") {
-            content.push({
-                type: "text",
-                text: `📊 Summary: ${result.attributes.length} attributes processed for note ${noteId}`
-            });
-        }
-    }
-    // Add guidance for template relations
-    if (result.success && operation === "batch_create") {
-        const templateRelations = result.attributes?.filter((attr) => attr.type === "relation" && attr.name === "template");
-        if (templateRelations && templateRelations.length > 0) {
-            content.push({
-                type: "text",
-                text: `🎯 Template relation detected: ${templateRelations[0].value}\nNote: Template functionality depends on the target note existing in your Trilium instance.`
-            });
-        }
-    }
-    // Add guidance for batch operations with conflicts
-    if (result.success && operation === "batch_create" && result.errors && result.errors.length > 0) {
-        const hasConflicts = result.errors.some((err) => err.includes("Skipping duplicate") || err.includes("already exist"));
-        if (hasConflicts) {
-            content.push({
-                type: "text",
-                text: `⚠️ **Batch Operation Summary**
-
-Some attributes were skipped due to conflicts (already existing). This is normal behavior for batch operations:
-
-✅ **Successfully created**: ${result.attributes?.length || 0} attributes
-❌ **Skipped duplicates**: ${result.errors?.filter((err) => err.includes("Skipping duplicate") || err.includes("already exist")).length || 0} attributes
-
-💡 **To manage skipped attributes**:
-- Use \`read_attributes\` to view current attributes
-- Use \`update\` operation to modify existing attributes
-- Use \`delete\` operation to remove unwanted attributes first
-
-This approach prevents accidental overwrites while allowing partial success for batch operations.`
-            });
-        }
-    }
-    return { content };
-}
-/**
- * Get help text for attribute management
- */
-export function get_manage_attributes_help() {
-    return `
-🔧 Attribute Management Tools
-
-manage_attributes: Create, update, delete attributes (write operations)
-
-📝 Usage Examples:
-
-🔧 Create a single label:
-   - noteId: "abc123"
-   - operation: "create"
-   - attributes: [{type: "label", name: "important", position: 10}]
-
-🔧 Create a template relation:
-   - noteId: "abc123"
-   - operation: "create"
-   - attributes: [{type: "relation", name: "template", value: "Board", position: 10}]
-
-🔧 Create multiple attributes (batch):
-   - noteId: "abc123"
-   - operation: "batch_create"
-   - attributes: [
-       {type: "label", name: "project", value: "api", position: 10},
-       {type: "label", name: "language", value: "python", position: 20},
-       {type: "relation", name: "template", value: "Grid View", position: 30}
-     ]
-
-🔧 Update an attribute:
-   - noteId: "abc123"
-   - operation: "update"
-   - attributes: [{type: "label", name: "important", position: 15}]
-
-🔧 Delete an attribute:
-   - noteId: "abc123"
-   - operation: "delete"
-   - attributes: [{type: "label", name: "important"}]
-
-🏷️  Label Syntax: #tagname or #tagname = "value"
-🔗 Relation Syntax: ~relationname = "target_value"
-
-⚡ Performance Tips:
-- Use "batch_create" for multiple attributes (faster than individual calls)
-- Template relations require the target note to exist in your Trilium instance
-- Position values control display order (lower numbers appear first)
-- Use read_attributes to view existing attributes before making changes
-
-🛡️ **Validation & Conflict Handling**:
-- Create operations now validate against existing attributes to prevent duplicates
-- If an attribute already exists, you'll get detailed error messages with guidance
-- Batch operations skip duplicates and continue with valid attributes
-- Use "update" to modify existing attributes, "create" for new ones only
-
-🔒 **Security**: Requires WRITE permission to manage note attributes.
-`;
-}
-//# sourceMappingURL=attributeManageHandler.js.map

package/build/modules/attributes/attributeManageHandler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"attributeManageHandler.js","sourceRoot":"","sources":["../../../src/modules/attributes/attributeManageHandler.ts"],"names":[],"mappings":"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"}

package/build/modules/attributes/attributeManageManager.d.ts

@@ -1,13 +0,0 @@
-/**
- * Attribute Manage Manager Module
- * Handles CRUD operations for note attributes (labels and relations)
- */
-import { AxiosInstance } from 'axios';
-import { ManageAttributesParams, Attribute, AttributeOperationResult } from '../shared/index.js';
-export type { ManageAttributesParams, Attribute, AttributeOperationResult };
-/**
- * Manage note attributes with write operations (create, update, delete)
- * This function provides write-only access to note attributes
- */
-export declare function manage_attributes(params: ManageAttributesParams, axiosInstance: AxiosInstance): Promise<AttributeOperationResult>;
-//# sourceMappingURL=attributeManageManager.d.ts.map

package/build/modules/attributes/attributeManageManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attributeManageManager.d.ts","sourceRoot":"","sources":["../../../src/modules/attributes/attributeManageManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC,OAAO,EACL,sBAAsB,EACtB,SAAS,EACT,wBAAwB,EACzB,MAAM,oBAAoB,CAAC;AAW5B,YAAY,EAAE,sBAAsB,EAAE,SAAS,EAAE,wBAAwB,EAAE,CAAC;AAsH5E;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,sBAAsB,EAC9B,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,wBAAwB,CAAC,CA6BnC"}