TriliumNext Notes 的 MCP 服务器

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

一个用于 TriliumNext Notes 的模型上下文协议服务器。此服务器提供通过 MCP 与您的 Trilium Notes 实例交互的工具。

更新：支持最新版本的 TriliumNext v0.92.6

注意：建议与 VSCode 中的 Cline 扩展一起使用，而不是 Claude Desktop

快速开始

首先确保设置您的环境变量：

• TRILIUM_API_URL (默认: http://localhost:8080/etapi)
• TRILIUM_API_TOKEN (必需，从您的 Trilium Notes 设置中获取)

安装

1. 与 Claude Desktop 一起使用

将服务器配置添加到您的 Claude Desktop 配置文件：

将以下配置添加到您的 Claude 配置文件中的 mcpServers 对象中：

用于开发 (在 Windows / Linux 上)

cd /path/to/triliumnext-mcp
npm run build

"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>"
  }
}

用于本地安装 (在 Linux 上)

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

用于本地安装 (在 Windows 上)

"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>"
  }
}

配置文件的位置：

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

可用工具

该服务器提供以下用于笔记管理的工具：

• search_notes - 搜索笔记

  • 需要: 搜索查询
  • 可选: fastSearch (全文搜索切换), includeArchivedNotes

• get_note - 通过 ID 检索笔记内容

  • 需要: 笔记 ID

• create_note - 创建新笔记

  • 需要: 父笔记 ID, 标题, 类型, 内容
  • 可选: 代码/文件/图像笔记的 MIME 类型
  • 支持的笔记类型: text, code, file, image, search, book, relationMap, render

• update_note - 更新现有笔记

  • 需要: 笔记 ID
  • 可选: 新标题, 新内容

• delete_note - 删除笔记

  • 需要: 笔记 ID

开发

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

# 克隆仓库
git clone https://github.com/tan-yong-sheng/triliumnext-mcp.git

# 安装依赖
npm install

# 构建服务器
npm run build

# 用于开发，自动重新构建
npm run watch