• 人工智能研究

  TriliumNext MCP 服务器：解锁与笔记交互的新方式

  發布人 Brave 2025-04-23 00:21

  对于广受欢迎的自托管笔记应用 Trilium Notes (及其分支 TriliumNext) 的用户，特别是开发者们，现在有了一个值得关注的新工具：TriliumNext Notes 的 MCP (Model Context Protocol) 服务器。

  ⚠️ 重要提示： 请注意，该工具目前仍处于 原型阶段 (针对 TriliumNext/Notes#705 提案)，主要 建议开发者使用。在尝试使用前，请务必 备份您的 Trilium 笔记数据 以防万一。 它是什么？

  简单来说，这是一个专门为 TriliumNext Notes 设计的服务器应用。它的核心功能是提供一个基于模型上下文协议 (MCP) 的接口，允许外部工具或应用程序（例如集成在 VSCode 中的 Cline 扩展，或者理论上也支持 Claude Desktop）与您的 Trilium 笔记实例进行交互。这意味着您可以通过编程方式或特定工具来搜索、读取、创建、更新甚至删除笔记。

  该服务器目前已更新，支持 TriliumNext v0.92.6 版本。开发者特别建议，为了获得更好的体验，优先考虑在 VSCode 中配合 Cline 扩展 使用，而非 Claude Desktop。

  快速开始：准备工作

  在启动和使用服务器之前，您需要设置两个关键的环境变量：

  1. TRILIUMAPIURL：您的 Trilium 实例的 ETAPI 地址。默认值为 http://localhost:8080/etapi，请根据您的实际部署情况修改。
  2. TRILIUMAPITOKEN：必需项。您需要从 Trilium Notes 的设置菜单中生成并获取这个 API 令牌。

  安装与配置

  根据您的使用场景，有多种安装和配置方式：

  开发环境 (Windows / Linux):

  1. 首先，克隆源代码仓库并进入目录：git clone https://github.com/tan-yong-sheng/triliumnext-mcp.git
  2. 安装依赖：npm install
  3. 构建项目：npm run build
  4. 之后，您可以通过类似 node /path/to/triliumnext-mcp/build/index.js 的命令启动服务器。

  本地安装 (推荐方式，使用 npx):

  1. Linux: 在终端运行 npx -y triliumnext-mcp 即可下载并运行。
  2. Windows: 在 cmd 提示符下运行 cmd /k npx -y triliumnext-mcp。
  3. 集成到 Claude Desktop (如果选择此方式):

  您需要编辑 Claude Desktop 的配置文件 (claudedesktopconfig.json)，在其 mcpServers 对象中添加配置。

  配置文件位置:

  • Windows: %APPDATA%/Claude/claudedesktopconfig.json
  • MacOS: ~/Library/Application Support/Claude/claudedesktopconfig.json

  For Local installation (on Linux)：

  "triliumnext-mcp": {
   "command": "npx",
   "args": [
         "-y",
         "triliumnext-mcp"
       ],
    "env": {
     "TRILIUM_API_URL": "http://localhost:8080/etapi",
     "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>"
   }
  }
   

  • 请记得将 "YOURAPITOKEN_HERE" 替换为您实际的 Trilium API Token。

  核心功能：可用的工具

  该 MCP 服务器目前提供了以下与 Trilium 笔记交互的工具：

  • search_notes: 搜索笔记。
  • 必需参数：search query (搜索关键词)
  • 可选参数：fastSearch (切换是否使用全文搜索), includeArchivedNotes (是否包含已存档笔记)
  • get_note: 根据 ID 获取笔记内容。
  • 必需参数：note ID (笔记 ID)
  • create_note: 创建新笔记。
  • 必需参数：parent note ID (父笔记 ID), title (标题), type (笔记类型), content (内容)
  • 可选参数：MIME type (用于代码/文件/图片笔记)
  • 支持的笔记类型：text, code, file, image, search, book, relationMap, render
  • update_note: 更新现有笔记。
  • 必需参数：note ID (笔记 ID)
  • 可选参数：new title (新标题), new content (新内容)
  • delete_note: 删除笔记。
  • 必需参数：note ID (笔记 ID)

  开发者参与

  如果您对该项目感兴趣，想要贡献代码或进行修改：

  1. 克隆仓库：git clone https://github.com/tan-yong-sheng/triliumnext-mcp.git
  2. 安装依赖：npm install
  3. 构建项目：npm run build
  4. 若需在开发时自动重新构建：npm run watch

  总结

  TriliumNext MCP 服务器为开发者和高级用户提供了一个强大的新途径，通过标准化的协议 (MCP) 来程序化地管理和操作 Trilium 笔记。虽然目前尚处原型阶段且推荐与 VSCode Cline 扩展结合使用，但它展示了扩展 Trilium 功能的巨大潜力。如果您是开发者并希望将 Trilium 集成到您的工作流或自动化工具中，这绝对是一个值得探索的项目。再次强调，使用前请务必 备份数据。

  Brave 回复 3 weeks, 3 days ago 1 成員 · 0 回复
• 0 回复

登入後即可回复