TriliumNext Notes' MCP Server

TriliumNext Notes的MCP服务器

⚠️ 免责声明：这是一个原型https://github.com/TriliumNext/Notes/issues/705.建议仅供开发人员使用。请在使用此工具之前备份您的Trinium笔记。 ⚠️

TriliumNext Notes的模型上下文协议服务器。此服务器提供通过MCP与Trilium Notes实例交互的工具。您可以将此MCP与 第三语言技能.

此外，如果您想同时将您的trinium实例备份到多个云存储提供商，如cloudflare R2、AWS S3和google drive，请访问： https://github.com/tan-yong-sheng/trilium-backup

建议的替代方案：

• perfectra1n/triliumnext mcp
• perfectra1n/triliumnext-cli

快速开始

请确保先设置环境变量：

• TRILIUM_API_URL （默认值：http://localhost:8080/etapi)
• TRILIUM_API_TOKEN （必填，从Trilium Notes设置中获取）
• PERMISSIONS （可选，默认值=“READ；WRITE”，其中READ授予对以下内容的访问权限 search_notes, get_note, resolve_note_id，以及 read_attributes，WRITE授予访问权限 create_note, update_note, delete_note，以及 manage_attributes)
• VERBOSE （可选，默认值='false'，如果为true，将打印详细的调试日志）

安装

以下是此MCP在不同MCP客户端（如Claude Desktop、Claude Code、Cursor、Cline等）上的安装指南。

Claude Desktop

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "triliumnext-mcp": {
      "command": "npx",
      "args": ["triliumnext-mcp"],
      "env": {
        "TRILIUM_API_URL": "http://localhost:8080/etapi",
        "TRILIUM_API_TOKEN": "",
        "PERMISSIONS": "READ;WRITE"
      }
    }
  }
}

Claude Code

claude mcp add triliumnext-mcp \
  -e TRILIUM_API_URL=http://localhost:8080/etapi \
  -e TRILIUM_API_TOKEN= \
  -e PERMISSIONS='READ;WRITE' \
  -- npx triliumnext-mcp

注意：通过更新，将MCP启动超时增加到1分钟，MCP工具执行超时增加到约5分钟 ~\.claude\settings.json 如下：

{
  "env": {
    "MCP_TIMEOUT": "60000",
    "MCP_TOOL_TIMEOUT": "300000"
  }
}

Cursor

转到：设置->光标设置->MCP->添加新的全局MCP服务器

建议将以下配置粘贴到Cursor~/.cours/mcp.json文件中。您还可以通过在项目文件夹中创建.cursor/mcp.json在特定项目中安装。看 光标MCP文档 了解更多信息。

{
  "mcpServers": {
    "triliumnext-mcp": {
      "command": "npx",
      "args": ["triliumnext-mcp"],
      "env": {
        "TRILIUM_API_URL": "http://localhost:8080/etapi",
        "TRILIUM_API_TOKEN": "",
        "PERMISSIONS": "READ;WRITE"
      }
    }
  }
}

Cline

Cline使用JSON配置文件来管理MCP服务器。要集成提供的MCP服务器配置：

1. 打开Cline并单击顶部导航栏中的MCP服务器图标。
2. 选择“已安装”选项卡，然后单击“高级MCP设置”。
3. 在cline_mcp_settings.json文件中，添加以下配置：

（i） 使用谷歌AI工作室提供商

{
  "mcpServers": {
    "timeout": 300, 
    "type": "stdio",
    "triliumnext-mcp": {
      "command": "npx",
      "args": ["triliumnext-mcp"],
      "env": {
        "TRILIUM_API_URL": "http://localhost:8080/etapi",
        "TRILIUM_API_TOKEN": "",
        "PERMISSIONS": "READ;WRITE"
      }
    }
  }
}

Other MCP clients

服务器使用stdio传输并遵循标准MCP协议。通过运行以下命令，它可以与任何兼容MCP的客户端集成：

npx triliumnext-mcp

Using Docker to run MCP (beta)

使用GitHub容器注册表中的预构建映像

拉取并运行最新图像：

docker pull ghcr.io/tan-yong-sheng/triliumnext-mcp:latest

然后，为您的mcp设置以下配置： （注意：请记住在此处更改TRILIUM_API_URL和TRILIUM-API_TOKEN）

{
  "mcpServers": {
    "triliumnext-mcp-docker": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "TRILIUM_API_URL",
        "-e",
        "TRILIUM_API_TOKEN",
        "-e",
        "PERMISSIONS",
        "-e",
        "VERBOSE",
        "ghcr.io/tan-yong-sheng/triliumnext-mcp:latest"
      ],
      "env": {
        "TRILIUM_API_URL": "https://trilium:8080/etapi",
        "TRILIUM_API_TOKEN": "",
        "PERMISSIONS": "READ;WRITE",
        "VERBOSE": "false"
      }
    }
  }
}

可用工具

服务器提供以下笔记管理工具：

搜索和发现工具

• search_notes -具有全面过滤功能的统一搜索，包括关键字搜索、日期范围、特定字段搜索、属性搜索、注释属性、基于模板的搜索、注释类型过滤、MIME类型过滤和层次导航。
• resolve_note_id -按标题查找笔记的ID。对于获取与其他工具一起使用的笔记ID至关重要。
• list_children_notes -使用确定性搜索查询列出父注释的直接子注释。返回按创建日期和标题排序的子摘要。

笔记管理工具

• get_note -按ID检索笔记及其内容。还可以与正则表达式一起使用，从内容中提取特定模式。
• create_note -创建新笔记。支持10种注释类型，并允许在同一步骤中创建属性（标签和关系）。
• update_note -更新笔记的标题或内容。需要a mode ('overwrite' 或 'append')指定更新类型和 expectedHash 以防止冲突。
• move_note -将笔记移动到新的父文件夹。使用 branchId 仅当注释有多个父分支时。
• patch_note -使用基于模式的补丁应用有针对性的批量编辑(css, xpath, line, fragment, literal, regex)通过原子验证。文字补丁可以使用 occurrence 可选 context 针对重复的文本。
• delete_note -永久删除笔记(⚠️ 无法撤消）。

属性管理工具

• read_attributes -读取给定注释的所有属性（标签和关系）。
• manage_attributes -在笔记上创建、更新或删除属性。支持批量创建。

📖 详细用法：参见 笔记管理指南 修订控制策略和最佳实践。

查询示例

搜索与发现

• “查找我自2024年初以来关于'n8n'的最新10条注释”
• “显示我在过去7天编辑的笔记”
• 列出“n8n Template”文件夹下的所有笔记，包括子文件夹
• “列出此文件夹的直接子笔记”

内容管理

• “将今天的更新添加到我的工作日志中”（使用 update_note 和 mode: 'append')
• “用最终版本替换此草案”（使用 update_note 和 mode: 'overwrite')
• “在我的日记文件夹中创建一个名为“每周回顾”的新笔记”

📖 更多示例：参见 用户查询示例 用于综合使用场景。

文档

• -使用Docker运行的完整指南
• 笔记管理指南 -具有修订控制的安全内容编辑
• 补丁注释指南 -有针对性的批量笔记编辑
• 移动笔记指南 -父母之间的移动笔记
• 列出儿童笔记指南 -直接儿童列表
• 用户查询示例 -自然语言查询示例
• 搜索查询示例 -高级搜索语法和过滤器

发展

如果您想贡献或修改服务器：

# Clone the repository
git clone https://github.com/tan-yong-sheng/triliumnext-mcp.git

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

贡献

请随时打开问题或提交拉取请求。