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
建议的替代方案：
快速开始
请确保先设置环境变量：
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服务器配置：
- 打开Cline并单击顶部导航栏中的MCP服务器图标。
- 选择“已安装”选项卡，然后单击“高级MCP设置”。
- 在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-mcpUsing 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-更新笔记的标题或内容。需要amode('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贡献
请随时打开问题或提交拉取请求。
