TriliumNext Notes' MCP Server

by tan-yong-sheng
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for interacting with a Trilium Notes instance, enabling note management operations including creating, searching, retrieving, updating, and deleting notes of various types (text, code, file, image, search, book, relationMap, render).

TriliumNext Notes 的 MCP 服务器

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

TriliumNext Notes 的模型上下文协议服务器。该服务器提供通过 MCP 与 Trilium Notes 实例进行交互的工具。

更新:支持最新版本TriliumNext v0.92.6

注意:建议在 VSCode 中使用 Cline 扩展,而不是 Claude Desktop

快速入门

确保首先设置环境变量:

安装

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 类型
    • 支持的笔记类型:文本、代码、文件、图像、搜索、书籍、关系图、渲染
  • update_note - 更新现有注释
    • 要求:笔记 ID
    • 可选:新标题、新内容
  • delete_note - 删除注释
    • 要求:笔记 ID

发展

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

# 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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

允许与 TriliumNext Notes 交互的模型上下文协议服务器,提供通过自然语言命令创建、搜索、检索、更新和删除笔记的工具。

  1. Quick Start
    1. Installation
      1. 1. Using with Claude Desktop
    2. Available Tools
      1. Development
        ID: rzhqu47to6