@iflow-mcp/h30190_trilium_mcp 1.0.0

package/.env

@@ -0,0 +1,2 @@
+TRILIUM_ETAPI_URL=http://localhost:8080/etapi
+TRILIUM_ETAPI_TOKEN=test_token_for_local_testing

package/.env.example

@@ -0,0 +1,2 @@
+TRILIUM_ETAPI_URL=http://localhost:8080/etapi
+TRILIUM_ETAPI_TOKEN=your_token_here

package/README.md

@@ -0,0 +1,205 @@
+# Trilium MCP Server
+
+[English](#english) | [繁體中文](#traditional-chinese)
+
+<a name="english"></a>
+
+## English
+
+> [!WARNING]
+> **Disclaimer & Backup Warning**
+>
+> This tool (MCP Server) has permissions to **write, modify** your Trilium notes.
+> **Please ensure you backup your Trilium library before performing any operations with this tool.**
+>
+> The author is not responsible for any data loss, corruption, or unexpected consequences resulting from the use of this tool. Use at your own risk.
+
+This is a Model Context Protocol (MCP) Server designed for [Trilium Notes](https://github.com/zadam/trilium). It allows AI agents (such as Claude Desktop, Gemini CLI, etc.) to interact directly with your Trilium notes library to search, read, write, and organize notes.
+
+### Features
+
+- **Search Notes (`search_notes`)**: Search notes by keywords.
+- **Read Note (`read_note`)**: Read note content and metadata.
+- **Create Note (`create_note`)**: Create new notes (supports text, code, etc.).
+- **Update Note (`update_note`)**: Modify existing note content or attributes.
+- **Move Note (`move_note`)**: Move notes to a new parent.
+- **Manage Attributes (`manage_attributes`)**: Add, modify, or delete note attributes.
+
+### Installation & Setup
+
+#### 1. Install Dependencies
+
+Ensure you have Node.js installed (v16+ recommended).
+
+```bash
+npm install
+```
+
+#### 2. Configure Environment Variables
+
+Create a `.env` file in the project root (see `.env.example`):
+
+```env
+TRILIUM_ETAPI_URL=http://localhost:8080/etapi
+TRILIUM_ETAPI_TOKEN=your_token_here
+```
+
+- `TRILIUM_ETAPI_URL`: Your Trilium ETAPI URL. Usually your Trilium URL appended with `/etapi`.
+- `TRILIUM_ETAPI_TOKEN`: The token created in Trilium's `Options` -> `ETAPI`.
+
+#### 3. Build Project
+
+```bash
+npm run build
+```
+
+### Usage
+
+#### Configuration for MCP Client
+
+For Claude Desktop or Gemini CLI, add the following to your configuration file (e.g., `claude_desktop_config.json` or `settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "trilium": {
+      "command": "node",
+      "args": ["/path/to/your/Trilium_MCP/dist/index.js"]
+    }
+  }
+}
+```
+
+**Note**:
+- Replace `/path/to/your/Trilium_MCP/dist/index.js` with the actual absolute path on your machine.
+- The program automatically reads the `.env` file from the project directory, so you don't need to repeat environment variables in the config file.
+
+### Development
+
+- **Build**: `npm run build`
+- **Test Connection**: `npx ts-node test-trilium.ts` (Requires `.env` setup)
+
+### License
+
+MIT
+
+### About the Author
+
+
+
+- Author: HJPLUS.DESIGN HAO.H
+- Website: [HJPLUS.DESIGN](https://www.hjplusdesign.com/)
+- Facebook Page: [HJPLUS.DESIGN](https://www.facebook.com/HJPLUS.DESIGN/)
+- Email: info@hjplusdesign.com
+
+We are external R&D partners for the design, architecture, and manufacturing industries. We specialize in helping companies without internal technical teams to implement digital workflows, tools, and AI, automating your knowledge and operational processes to supplement your team's skill upgrades.
+We specialize in solving the following situations:
+- Companies with design and manufacturing capabilities but lacking tools and processes for technical integration.
+- Teams without technical personnel or teams that need automation or data integration.
+- Complex projects with multiple data formats but lacking integration experience.
+- Wanting to implement AI or BIM but not knowing where to start.
+- Needing project-based digital consulting or tool development support.
+- Needing complex geometric analysis modeling or BIM project consulting.
+For more digital transformation consulting and service details, please contact us.
+
+---
+
+<a name="traditional-chinese"></a>
+
+## 繁體中文 (Traditional Chinese)
+
+> [!WARNING]
+> **免責聲明與備份提醒**
+>
+> 本工具 (MCP Server) 具有對您的 Trilium 筆記庫進行**寫入、修改**的權限。
+> **在使用本工具進行任何操作之前，請務必備份您的 Trilium 筆記庫。**
+>
+> 作者不對因使用本工具而導致的任何資料遺失、損壞或不可預期的後果負責。使用者需自行承擔使用風險。
+
+這是一個為 [Trilium Notes](https://github.com/zadam/trilium) 設計的 Model Context Protocol (MCP) Server。它允許 AI 代理 (如 Claude Desktop, Gemini CLI 等) 直接與您的 Trilium 筆記庫互動，執行搜尋、讀取、寫入和整理筆記等操作。
+
+### 功能
+
+- **搜尋筆記 (`search_notes`)**: 透過關鍵字搜尋筆記。
+- **讀取筆記 (`read_note`)**: 讀取筆記的內容與屬性 (Metadata)。
+- **建立筆記 (`create_note`)**: 建立新的筆記 (支援文字、程式碼等各種類型)。
+- **更新筆記 (`update_note`)**: 修改現有筆記的內容或屬性。
+- **移動筆記 (`move_note`)**: 將筆記移動到新的父節點下。
+- **管理屬性 (`manage_attributes`)**: 新增、修改或刪除筆記的屬性 (Attributes)。
+
+### 安裝與設定
+
+#### 1. 安裝依賴
+
+確保您已安裝 Node.js (建議 v16 以上)。
+
+```bash
+npm install
+```
+
+#### 2. 設定環境變數
+
+在專案根目錄建立 `.env` 檔案 (可參考 `.env.example`)：
+
+```env
+TRILIUM_ETAPI_URL=http://localhost:8080/etapi
+TRILIUM_ETAPI_TOKEN=your_token_here
+```
+
+- `TRILIUM_ETAPI_URL`: 您的 Trilium ETAPI 網址。通常是您的 Trilium 網址加上 `/etapi`。
+- `TRILIUM_ETAPI_TOKEN`: 在 Trilium 的 `Options` -> `ETAPI` 中建立的 Token。
+
+#### 3. 編譯專案
+
+```bash
+npm run build
+```
+
+### 使用方法
+
+#### 在 MCP Client 中設定
+
+以 Claude Desktop 或 Gemini CLI 為例，請在設定檔 (如 `claude_desktop_config.json` 或 `settings.json`) 中加入以下設定：
+
+```json
+{
+  "mcpServers": {
+    "trilium": {
+      "command": "node",
+      "args": ["/path/to/your/Trilium_MCP/dist/index.js"]
+    }
+  }
+}
+```
+
+**注意**：
+- 請將 `/path/to/your/Trilium_MCP/dist/index.js` 替換為您實際的檔案路徑。
+- 程式會自動讀取專案目錄下的 `.env` 檔案，因此不需要在設定檔中重複填寫環境變數。
+
+### 開發
+
+- **編譯**: `npm run build`
+- **測試連線**: `npx ts-node test-trilium.ts` (需先設定好 `.env`)
+
+### 授權
+
+MIT
+
+### 關於作者
+
+
+
+- 作者: 加號設計數位工程有限公司 HAO.H
+- 網站: [加號設計數位工程有限公司](https://www.hjplusdesign.com/)
+- 粉絲專頁: [加號設計數位工程有限公司](https://www.facebook.com/HJPLUS.DESIGN/)
+- 電子郵件: info@hjplusdesign.com
+
+我們是設計、建築與製造產業的外部研發夥伴，專門協助缺乏內部技術團隊的公司導入數位工作流程、工具與 AI，自動化你的知識與作業流程，以補足團隊技能升級的能量。
+我們專門解決以下情況：
+- 公司有設計與製造能量，但缺乏技術整合的工具與流程
+- 團隊中沒技術人員或團隊，卻需要自動化或資料串接
+- 專案複雜、資料格式多，但缺乏整合經驗
+- 想導入 AI 或 BIM，但不知道從哪開始
+- 需要專案型的數位顧問或工具開發支援
+- 需要處理複雜幾何分析建模或BIM專案顧問
+更多數位轉型諮詢與服務內容歡迎與我們聯絡。

package/dist/index.js

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import dotenv from "dotenv";
+import { TriliumClient } from "./trilium-client.js";
+import path from "path";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Load .env from the project root (assuming dist/index.js is one level deep)
+dotenv.config({ path: path.resolve(__dirname, "../.env") });
+const TRILIUM_ETAPI_URL = process.env.TRILIUM_ETAPI_URL;
+const TRILIUM_ETAPI_TOKEN = process.env.TRILIUM_ETAPI_TOKEN;
+const TEST_MODE = process.env.TEST_MODE === "true";
+if (!TRILIUM_ETAPI_URL || !TRILIUM_ETAPI_TOKEN) {
+    console.error("Error: TRILIUM_ETAPI_URL and TRILIUM_ETAPI_TOKEN must be set in .env");
+    process.exit(1);
+}
+const trilium = new TriliumClient(TRILIUM_ETAPI_URL, TRILIUM_ETAPI_TOKEN, TEST_MODE);
+const server = new Server({
+    name: "trilium-mcp",
+    version: "V1.0.0(251124_HJPLUS.DESIGN)",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Tool Schemas
+const searchNotesSchema = z.object({
+    query: z.string().describe("The search query string"),
+});
+const readNoteSchema = z.object({
+    noteId: z.string().describe("The ID of the note to read"),
+});
+const createNoteSchema = z.object({
+    parentNoteId: z.string().describe("The ID of the parent note"),
+    title: z.string().describe("The title of the new note"),
+    type: z.string().default("text").describe("The type of the note (e.g., text, code)"),
+    content: z.string().optional().describe("The initial content of the note"),
+    mime: z.string().optional().describe("MIME type for the note"),
+});
+const updateNoteSchema = z.object({
+    noteId: z.string().describe("The ID of the note to update"),
+    title: z.string().optional().describe("New title"),
+    type: z.string().optional().describe("New type"),
+    content: z.string().optional().describe("New content"),
+    mime: z.string().optional().describe("New MIME type"),
+});
+const moveNoteSchema = z.object({
+    noteId: z.string().describe("The ID of the note to move"),
+    parentNoteId: z.string().describe("The ID of the new parent note"),
+});
+const manageAttributesSchema = z.object({
+    action: z.enum(["create", "update", "delete"]).describe("The action to perform"),
+    noteId: z.string().optional().describe("The ID of the note (required for create)"),
+    attributeId: z.string().optional().describe("The ID of the attribute (required for update/delete)"),
+    type: z.enum(["label", "relation"]).optional().describe("Type of attribute (required for create)"),
+    name: z.string().optional().describe("Name of the attribute (required for create)"),
+    value: z.string().optional().describe("Value of the attribute"),
+    isInheritable: z.boolean().optional().describe("Whether the attribute is inheritable"),
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "search_notes",
+                description: "Search for notes in Trilium",
+                inputSchema: zodToJsonSchema(searchNotesSchema),
+            },
+            {
+                name: "read_note",
+                description: "Read a note's metadata and content",
+                inputSchema: zodToJsonSchema(readNoteSchema),
+            },
+            {
+                name: "create_note",
+                description: "Create a new note",
+                inputSchema: zodToJsonSchema(createNoteSchema),
+            },
+            {
+                name: "update_note",
+                description: "Update an existing note",
+                inputSchema: zodToJsonSchema(updateNoteSchema),
+            },
+            {
+                name: "move_note",
+                description: "Move a note to a new parent",
+                inputSchema: zodToJsonSchema(moveNoteSchema),
+            },
+            {
+                name: "manage_attributes",
+                description: "Manage note attributes (create, update, delete)",
+                inputSchema: zodToJsonSchema(manageAttributesSchema),
+            },
+        ],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        switch (name) {
+            case "search_notes": {
+                const { query } = searchNotesSchema.parse(args);
+                const results = await trilium.searchNotes(query);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+                };
+            }
+            case "read_note": {
+                const { noteId } = readNoteSchema.parse(args);
+                const note = await trilium.getNote(noteId);
+                const content = await trilium.getNoteContent(noteId);
+                return {
+                    content: [
+                        { type: "text", text: `Metadata:\n${JSON.stringify(note, null, 2)}\n\nContent:\n${content}` },
+                    ],
+                };
+            }
+            case "create_note": {
+                const params = createNoteSchema.parse(args);
+                const note = await trilium.createNote(params);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(note, null, 2) }],
+                };
+            }
+            case "update_note": {
+                const { noteId, ...params } = updateNoteSchema.parse(args);
+                const note = await trilium.updateNote(noteId, params);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(note, null, 2) }],
+                };
+            }
+            case "move_note": {
+                const { noteId, parentNoteId } = moveNoteSchema.parse(args);
+                const note = await trilium.moveNote(noteId, parentNoteId);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(note, null, 2) }],
+                };
+            }
+            case "manage_attributes": {
+                const { action, noteId, attributeId, type, name, value, isInheritable } = manageAttributesSchema.parse(args);
+                if (action === "create") {
+                    if (!noteId || !type || !name || value === undefined) {
+                        throw new Error("Missing required parameters for create attribute");
+                    }
+                    const attr = await trilium.createAttribute(noteId, type, name, value, isInheritable);
+                    return { content: [{ type: "text", text: JSON.stringify(attr, null, 2) }] };
+                }
+                else if (action === "update") {
+                    if (!attributeId || value === undefined) {
+                        throw new Error("Missing required parameters for update attribute");
+                    }
+                    await trilium.updateAttribute(attributeId, value, isInheritable);
+                    return { content: [{ type: "text", text: "Attribute updated" }] };
+                }
+                else if (action === "delete") {
+                    if (!attributeId) {
+                        throw new Error("Missing attributeId for delete attribute");
+                    }
+                    await trilium.deleteAttribute(attributeId);
+                    return { content: [{ type: "text", text: "Attribute deleted" }] };
+                }
+                return { content: [{ type: "text", text: "Invalid action" }] };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${errorMessage}` }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});

package/dist/trilium-client.js

@@ -0,0 +1,170 @@
+import axios from 'axios';
+export class TriliumClient {
+    client;
+    testMode;
+    constructor(baseUrl, token, testMode = false) {
+        this.testMode = testMode;
+        this.client = axios.create({
+            baseURL: baseUrl,
+            headers: {
+                'Authorization': token,
+                'Content-Type': 'application/json',
+            },
+        });
+    }
+    async searchNotes(query) {
+        if (this.testMode) {
+            return {
+                results: [
+                    {
+                        noteId: "test-note-1",
+                        title: `Test Note: ${query}`,
+                        type: "text",
+                        mime: "text/html",
+                        isProtected: false,
+                        dateCreated: new Date().toISOString(),
+                        dateModified: new Date().toISOString(),
+                        parentNoteIds: ["root"],
+                        childNoteIds: []
+                    }
+                ]
+            };
+        }
+        const response = await this.client.get('/notes', {
+            params: { search: query },
+        });
+        return response.data;
+    }
+    async getNote(noteId) {
+        if (this.testMode) {
+            return {
+                noteId: noteId,
+                title: "Test Note",
+                type: "text",
+                mime: "text/html",
+                isProtected: false,
+                dateCreated: new Date().toISOString(),
+                dateModified: new Date().toISOString(),
+                parentNoteIds: ["root"],
+                childNoteIds: []
+            };
+        }
+        const response = await this.client.get(`/notes/${noteId}`);
+        return response.data;
+    }
+    async getNoteContent(noteId) {
+        if (this.testMode) {
+            return `<p>This is test content for note ${noteId}</p>`;
+        }
+        const response = await this.client.get(`/notes/${noteId}/content`, {
+            responseType: 'text',
+        });
+        return response.data;
+    }
+    async createNote(params) {
+        if (this.testMode) {
+            return {
+                noteId: "new-test-note",
+                title: params.title,
+                type: params.type,
+                mime: params.mime || "text/html",
+                isProtected: false,
+                dateCreated: new Date().toISOString(),
+                dateModified: new Date().toISOString(),
+                parentNoteIds: [params.parentNoteId],
+                childNoteIds: []
+            };
+        }
+        const response = await this.client.post('/create-note', params);
+        return response.data;
+    }
+    async updateNote(noteId, params) {
+        if (this.testMode) {
+            return {
+                noteId: noteId,
+                title: params.title || "Updated Test Note",
+                type: params.type || "text",
+                mime: params.mime || "text/html",
+                isProtected: false,
+                dateCreated: new Date().toISOString(),
+                dateModified: new Date().toISOString(),
+                parentNoteIds: ["root"],
+                childNoteIds: []
+            };
+        }
+        // Update metadata
+        if (params.title || params.type || params.mime) {
+            await this.client.patch(`/notes/${noteId}`, {
+                title: params.title,
+                type: params.type,
+                mime: params.mime
+            });
+        }
+        // Update content if provided
+        if (params.content !== undefined) {
+            await this.client.put(`/notes/${noteId}/content`, params.content, {
+                headers: { 'Content-Type': 'text/plain' } // Assuming text content for now
+            });
+        }
+        return this.getNote(noteId);
+    }
+    async moveNote(noteId, parentNoteId) {
+        if (this.testMode) {
+            return {
+                noteId: noteId,
+                title: "Moved Test Note",
+                type: "text",
+                mime: "text/html",
+                isProtected: false,
+                dateCreated: new Date().toISOString(),
+                dateModified: new Date().toISOString(),
+                parentNoteIds: [parentNoteId],
+                childNoteIds: []
+            };
+        }
+        // In Trilium, moving a note usually means changing its parent.
+        // We can use PATCH to update parentNoteIds.
+        // WARNING: This replaces all parents. If a note is cloned, this might unclone it from other locations.
+        // For simple "move", this is acceptable.
+        await this.client.patch(`/notes/${noteId}`, {
+            parentNoteIds: [parentNoteId],
+        });
+        return this.getNote(noteId);
+    }
+    // Attribute Management
+    async createAttribute(noteId, type, name, value, isInheritable = false) {
+        if (this.testMode) {
+            return {
+                attributeId: "test-attr-1",
+                noteId: noteId,
+                type: type,
+                name: name,
+                value: value,
+                isInheritable: isInheritable || false
+            };
+        }
+        const response = await this.client.post('/attributes', {
+            noteId,
+            type,
+            name,
+            value,
+            isInheritable,
+        });
+        return response.data;
+    }
+    async updateAttribute(attributeId, value, isInheritable) {
+        if (this.testMode) {
+            return;
+        }
+        await this.client.patch(`/attributes/${attributeId}`, {
+            value,
+            isInheritable
+        });
+    }
+    async deleteAttribute(attributeId) {
+        if (this.testMode) {
+            return;
+        }
+        await this.client.delete(`/attributes/${attributeId}`);
+    }
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@iflow-mcp/h30190_trilium_mcp",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "trilium-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "http://192.168.0.125:3004/HJPLUS/Trilium_MCP.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "@types/node": "^24.10.1",
+    "axios": "^1.13.2",
+    "dotenv": "^17.2.3",
+    "typescript": "^5.9.3",
+    "zod": "^3.23.8",
+    "zod-to-json-schema": "^3.23.5"
+  }
+}

package/src/index.ts

@@ -0,0 +1,214 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+    CallToolRequestSchema,
+    ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import dotenv from "dotenv";
+import { TriliumClient } from "./trilium-client.js";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Load .env from the project root (assuming dist/index.js is one level deep)
+dotenv.config({ path: path.resolve(__dirname, "../.env") });
+
+const TRILIUM_ETAPI_URL = process.env.TRILIUM_ETAPI_URL;
+const TRILIUM_ETAPI_TOKEN = process.env.TRILIUM_ETAPI_TOKEN;
+const TEST_MODE = process.env.TEST_MODE === "true";
+
+if (!TRILIUM_ETAPI_URL || !TRILIUM_ETAPI_TOKEN) {
+    console.error("Error: TRILIUM_ETAPI_URL and TRILIUM_ETAPI_TOKEN must be set in .env");
+    process.exit(1);
+}
+
+const trilium = new TriliumClient(TRILIUM_ETAPI_URL, TRILIUM_ETAPI_TOKEN, TEST_MODE);
+
+const server = new Server(
+    {
+        name: "trilium-mcp",
+        version: "V1.0.0(251124_HJPLUS.DESIGN)",
+    },
+    {
+        capabilities: {
+            tools: {},
+        },
+    }
+);
+
+// Tool Schemas
+const searchNotesSchema = z.object({
+    query: z.string().describe("The search query string"),
+});
+
+const readNoteSchema = z.object({
+    noteId: z.string().describe("The ID of the note to read"),
+});
+
+const createNoteSchema = z.object({
+    parentNoteId: z.string().describe("The ID of the parent note"),
+    title: z.string().describe("The title of the new note"),
+    type: z.string().default("text").describe("The type of the note (e.g., text, code)"),
+    content: z.string().optional().describe("The initial content of the note"),
+    mime: z.string().optional().describe("MIME type for the note"),
+});
+
+const updateNoteSchema = z.object({
+    noteId: z.string().describe("The ID of the note to update"),
+    title: z.string().optional().describe("New title"),
+    type: z.string().optional().describe("New type"),
+    content: z.string().optional().describe("New content"),
+    mime: z.string().optional().describe("New MIME type"),
+});
+
+const moveNoteSchema = z.object({
+    noteId: z.string().describe("The ID of the note to move"),
+    parentNoteId: z.string().describe("The ID of the new parent note"),
+});
+
+const manageAttributesSchema = z.object({
+    action: z.enum(["create", "update", "delete"]).describe("The action to perform"),
+    noteId: z.string().optional().describe("The ID of the note (required for create)"),
+    attributeId: z.string().optional().describe("The ID of the attribute (required for update/delete)"),
+    type: z.enum(["label", "relation"]).optional().describe("Type of attribute (required for create)"),
+    name: z.string().optional().describe("Name of the attribute (required for create)"),
+    value: z.string().optional().describe("Value of the attribute"),
+    isInheritable: z.boolean().optional().describe("Whether the attribute is inheritable"),
+});
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "search_notes",
+                description: "Search for notes in Trilium",
+                inputSchema: zodToJsonSchema(searchNotesSchema as any),
+            },
+            {
+                name: "read_note",
+                description: "Read a note's metadata and content",
+                inputSchema: zodToJsonSchema(readNoteSchema as any),
+            },
+            {
+                name: "create_note",
+                description: "Create a new note",
+                inputSchema: zodToJsonSchema(createNoteSchema as any),
+            },
+            {
+                name: "update_note",
+                description: "Update an existing note",
+                inputSchema: zodToJsonSchema(updateNoteSchema as any),
+            },
+            {
+                name: "move_note",
+                description: "Move a note to a new parent",
+                inputSchema: zodToJsonSchema(moveNoteSchema as any),
+            },
+            {
+                name: "manage_attributes",
+                description: "Manage note attributes (create, update, delete)",
+                inputSchema: zodToJsonSchema(manageAttributesSchema as any),
+            },
+        ],
+    };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request: any) => {
+    try {
+        const { name, arguments: args } = request.params;
+
+        switch (name) {
+            case "search_notes": {
+                const { query } = searchNotesSchema.parse(args);
+                const results = await trilium.searchNotes(query);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+                };
+            }
+
+            case "read_note": {
+                const { noteId } = readNoteSchema.parse(args);
+                const note = await trilium.getNote(noteId);
+                const content = await trilium.getNoteContent(noteId);
+                return {
+                    content: [
+                        { type: "text", text: `Metadata:\n${JSON.stringify(note, null, 2)}\n\nContent:\n${content}` },
+                    ],
+                };
+            }
+
+            case "create_note": {
+                const params = createNoteSchema.parse(args);
+                const note = await trilium.createNote(params);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(note, null, 2) }],
+                };
+            }
+
+            case "update_note": {
+                const { noteId, ...params } = updateNoteSchema.parse(args);
+                const note = await trilium.updateNote(noteId, params);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(note, null, 2) }],
+                };
+            }
+
+            case "move_note": {
+                const { noteId, parentNoteId } = moveNoteSchema.parse(args);
+                const note = await trilium.moveNote(noteId, parentNoteId);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(note, null, 2) }],
+                };
+            }
+
+            case "manage_attributes": {
+                const { action, noteId, attributeId, type, name, value, isInheritable } = manageAttributesSchema.parse(args);
+
+                if (action === "create") {
+                    if (!noteId || !type || !name || value === undefined) {
+                        throw new Error("Missing required parameters for create attribute");
+                    }
+                    const attr = await trilium.createAttribute(noteId, type, name, value, isInheritable);
+                    return { content: [{ type: "text", text: JSON.stringify(attr, null, 2) }] };
+                } else if (action === "update") {
+                    if (!attributeId || value === undefined) {
+                        throw new Error("Missing required parameters for update attribute");
+                    }
+                    await trilium.updateAttribute(attributeId, value, isInheritable);
+                    return { content: [{ type: "text", text: "Attribute updated" }] };
+                } else if (action === "delete") {
+                    if (!attributeId) {
+                        throw new Error("Missing attributeId for delete attribute");
+                    }
+                    await trilium.deleteAttribute(attributeId);
+                    return { content: [{ type: "text", text: "Attribute deleted" }] };
+                }
+                return { content: [{ type: "text", text: "Invalid action" }] };
+            }
+
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${errorMessage}` }],
+            isError: true,
+        };
+    }
+});
+
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});

package/src/trilium-client.ts

@@ -0,0 +1,184 @@
+import axios, { AxiosInstance } from 'axios';
+import { Note, NoteContent, CreateNoteParams, UpdateNoteParams, Attribute, SearchResult } from './types.js';
+
+export class TriliumClient {
+    private client: AxiosInstance;
+    private testMode: boolean;
+
+    constructor(baseUrl: string, token: string, testMode: boolean = false) {
+        this.testMode = testMode;
+        this.client = axios.create({
+            baseURL: baseUrl,
+            headers: {
+                'Authorization': token,
+                'Content-Type': 'application/json',
+            },
+        });
+    }
+
+    async searchNotes(query: string): Promise<SearchResult> {
+        if (this.testMode) {
+            return {
+                results: [
+                    {
+                        noteId: "test-note-1",
+                        title: `Test Note: ${query}`,
+                        type: "text",
+                        mime: "text/html",
+                        isProtected: false,
+                        dateCreated: new Date().toISOString(),
+                        dateModified: new Date().toISOString(),
+                        parentNoteIds: ["root"],
+                        childNoteIds: []
+                    }
+                ]
+            };
+        }
+        const response = await this.client.get<SearchResult>('/notes', {
+            params: { search: query },
+        });
+        return response.data;
+    }
+
+    async getNote(noteId: string): Promise<Note> {
+        if (this.testMode) {
+            return {
+                noteId: noteId,
+                title: "Test Note",
+                type: "text",
+                mime: "text/html",
+                isProtected: false,
+                dateCreated: new Date().toISOString(),
+                dateModified: new Date().toISOString(),
+                parentNoteIds: ["root"],
+                childNoteIds: []
+            };
+        }
+        const response = await this.client.get<Note>(`/notes/${noteId}`);
+        return response.data;
+    }
+
+    async getNoteContent(noteId: string): Promise<string> {
+        if (this.testMode) {
+            return `<p>This is test content for note ${noteId}</p>`;
+        }
+        const response = await this.client.get(`/notes/${noteId}/content`, {
+            responseType: 'text',
+        });
+        return response.data;
+    }
+
+    async createNote(params: CreateNoteParams): Promise<Note> {
+        if (this.testMode) {
+            return {
+                noteId: "new-test-note",
+                title: params.title,
+                type: params.type,
+                mime: params.mime || "text/html",
+                isProtected: false,
+                dateCreated: new Date().toISOString(),
+                dateModified: new Date().toISOString(),
+                parentNoteIds: [params.parentNoteId],
+                childNoteIds: []
+            };
+        }
+        const response = await this.client.post<Note>('/create-note', params);
+        return response.data;
+    }
+
+    async updateNote(noteId: string, params: UpdateNoteParams): Promise<Note> {
+        if (this.testMode) {
+            return {
+                noteId: noteId,
+                title: params.title || "Updated Test Note",
+                type: params.type || "text",
+                mime: params.mime || "text/html",
+                isProtected: false,
+                dateCreated: new Date().toISOString(),
+                dateModified: new Date().toISOString(),
+                parentNoteIds: ["root"],
+                childNoteIds: []
+            };
+        }
+        // Update metadata
+        if (params.title || params.type || params.mime) {
+            await this.client.patch(`/notes/${noteId}`, {
+                title: params.title,
+                type: params.type,
+                mime: params.mime
+            });
+        }
+
+        // Update content if provided
+        if (params.content !== undefined) {
+            await this.client.put(`/notes/${noteId}/content`, params.content, {
+                headers: { 'Content-Type': 'text/plain' } // Assuming text content for now
+            });
+        }
+
+        return this.getNote(noteId);
+    }
+
+    async moveNote(noteId: string, parentNoteId: string): Promise<Note> {
+        if (this.testMode) {
+            return {
+                noteId: noteId,
+                title: "Moved Test Note",
+                type: "text",
+                mime: "text/html",
+                isProtected: false,
+                dateCreated: new Date().toISOString(),
+                dateModified: new Date().toISOString(),
+                parentNoteIds: [parentNoteId],
+                childNoteIds: []
+            };
+        }
+        // In Trilium, moving a note usually means changing its parent.
+        // We can use PATCH to update parentNoteIds.
+        // WARNING: This replaces all parents. If a note is cloned, this might unclone it from other locations.
+        // For simple "move", this is acceptable.
+        await this.client.patch(`/notes/${noteId}`, {
+            parentNoteIds: [parentNoteId],
+        });
+        return this.getNote(noteId);
+    }
+
+    // Attribute Management
+    async createAttribute(noteId: string, type: 'label' | 'relation', name: string, value: string, isInheritable: boolean = false): Promise<Attribute> {
+        if (this.testMode) {
+            return {
+                attributeId: "test-attr-1",
+                noteId: noteId,
+                type: type,
+                name: name,
+                value: value,
+                isInheritable: isInheritable || false
+            };
+        }
+        const response = await this.client.post<Attribute>('/attributes', {
+            noteId,
+            type,
+            name,
+            value,
+            isInheritable,
+        });
+        return response.data;
+    }
+
+    async updateAttribute(attributeId: string, value: string, isInheritable?: boolean): Promise<void> {
+        if (this.testMode) {
+            return;
+        }
+        await this.client.patch(`/attributes/${attributeId}`, {
+            value,
+            isInheritable
+        });
+    }
+
+    async deleteAttribute(attributeId: string): Promise<void> {
+        if (this.testMode) {
+            return;
+        }
+        await this.client.delete(`/attributes/${attributeId}`);
+    }
+}

package/src/types.ts

@@ -0,0 +1,45 @@
+export interface Note {
+    noteId: string;
+    title: string;
+    type: string;
+    mime: string;
+    isProtected: boolean;
+    dateCreated: string;
+    dateModified: string;
+    parentNoteIds: string[];
+    childNoteIds: string[];
+    attributes?: Attribute[];
+}
+
+export interface Attribute {
+    attributeId: string;
+    noteId: string;
+    type: 'label' | 'relation';
+    name: string;
+    value: string;
+    isInheritable: boolean;
+}
+
+export interface NoteContent {
+    noteId: string;
+    content: string;
+}
+
+export interface SearchResult {
+    results: Note[];
+}
+
+export interface CreateNoteParams {
+    parentNoteId: string;
+    title: string;
+    type: string;
+    content?: string;
+    mime?: string;
+}
+
+export interface UpdateNoteParams {
+    title?: string;
+    type?: string;
+    mime?: string;
+    content?: string;
+}

package/trilium_mcp_process.log

@@ -0,0 +1,26 @@
+[2025-12-29] Trilium MCP 处理日志
+
+项目信息:
+- 原始仓库: https://github.com/h30190/Trilium_MCP
+- Fork地址: https://github.com/iflow-mcp/trilium_mcp
+- 本地路径: /Users/jiashuowang/MCPs/提示词项目/iflow_auto_import/data/trilium_mcp
+- 项目类型: Node.js
+
+[2025-12-29] [✅] 获取项目信息: GitHub地址和项目名称
+
+[2025-12-29] [✅] 阅读代码:
+- 项目为Node.js TypeScript项目
+- 入口文件: src/index.ts
+- 构建输出: dist/index.js
+- 依赖: @modelcontextprotocol/sdk, axios, dotenv, zod
+- 工具列表:
+  1. search_notes - 搜索笔记
+  2. read_note - 读取笔记
+  3. create_note - 创建笔记
+  4. update_note - 更新笔记
+  5. move_note - 移动笔记
+  6. manage_attributes - 管理属性
+- 传输协议: stdio
+- 需要环境变量: TRILIUM_ETAPI_URL, TRILIUM_ETAPI_TOKEN
+
+[2025-12-29] [✅] 本地测试: 成功获取到6个工具，测试通过

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
+}