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 获取笔记内容create_note
创建新笔记- 要求:父笔记 ID、标题、类型、内容
- 可选:代码/文件/图像注释的 MIME 类型
- 支持的笔记类型:文本、代码、文件、图像、搜索、书籍、关系图、渲染
update_note
- 更新现有注释delete_note
- 删除注释
发展
如果您想贡献或修改服务器:
# 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