Trilium MCP

Trinium MCP服务器 v1.0.1

英语 | 繁体中文

英语

\[！警告\] 免责声明和备份警告 此工具（MCP服务器）具有以下权限 写入、修改 你的Trillium笔记。 在使用此工具执行任何操作之前，请确保备份Trinium库。 作者不对因使用此工具而导致的任何数据丢失、损坏或意外后果负责。使用风险自负。

这是一个模型上下文协议（MCP）服务器，专为 三锂笔记它允许AI代理（如Claude Desktop、Gemini CLI等）直接与您的Trinium笔记库交互，以搜索、读取、写入和组织笔记。

特性

• 搜索备注(search_notes)：按关键字搜索笔记。
• 阅读备注(read_note)：读取笔记内容和基本元数据（针对大笔记进行了优化）。
• 获取笔记元数据(get_note_metadata)：获取完整的笔记元数据，包括属性、标签和关系。
• 创建笔记(create_note)：创建新笔记（支持文本、代码等）。
• 更新说明(update_note)：修改现有注释内容或属性。
• 移动笔记(move_note)：将笔记移动到新的父级。
• 管理属性(manage_attributes)：添加、修改或删除注释属性。

安装和设置

1.安装依赖项

确保您已安装Node.js（建议使用v16+）。

npm install

2.配置环境变量

创建 .env 项目根目录中的文件（请参见 .env.example):

TRILIUM_ETAPI_URL=http://localhost:8080/etapi
TRILIUM_ETAPI_TOKEN=your_token_here

• TRILIUM_ETAPI_URL：您的Trinium ETAPI URL。通常您的Triium URL会附加 /etapi.
• TRILIUM_ETAPI_TOKEN：在Trilium中创建的令牌 Options -> ETAPI.

3.建设项目

npm run build

用法

MCP客户端的配置

对于Claude Desktop或Gemini CLI，请在配置文件中添加以下内容（例如。， claude_desktop_config.json 或 settings.json):

{
  "mcpServers": {
    "trilium": {
      "command": "node",
      "args": ["/path/to/your/Trilium_MCP/dist/index.js"]
    }
  }
}

备注:

• 替换 /path/to/your/Trilium_MCP/dist/index.js 使用机器上的实际绝对路径。
• 程序会自动读取 .env 文件来自项目目录，因此您不需要在配置文件中重复环境变量。

发展

• 构建: npm run build
• 测试连接: npx ts-node test-trilium.ts （需要 .env 设置）

许可证

麻省理工学院

关于作者

• 作者：HJPLUS。设计好。H
• 网站： HJPLUS。设计
• 脸书页面： HJPLUS。设计
• 电子邮件：info@hjplusdesign.com

我们是设计、建筑和制造业的外部研发合作伙伴。我们专注于帮助没有内部技术团队的公司实施数字工作流程、工具和人工智能，自动化您的知识和操作流程，以补充您团队的技能升级。 我们专注于解决以下情况：

• 具有设计和制造能力但缺乏技术集成工具和流程的公司。
• 没有技术人员的团队或需要自动化或数据集成的团队。
• 具有多种数据格式但缺乏集成经验的复杂项目。
• 想要实施AI或BIM，但不知道从哪里开始。
• 需要基于项目的数字咨询或工具开发支持。
• 需要复杂的几何分析建模或BIM项目咨询。

如需更多数字化转型咨询和服务详情，请联系我们。

______________________________________________________________________

繁体中文（Traditional Chinese）

\[！警告\] 免责声明与备份提醒 本工具（MCP Server）具有对您的Trilium 笔记库进行写入、修改的权限。 在使用本工具进行任何操作之前，请务必备份您的Trilium 笔记库。 作者不对因使用本工具而导致的任何数据遗失、损坏或不可预期的后果负责。使用者需自行承担使用风险。

这是一个为 三锂笔记 设计的Model Context Protocol (MCP) Server。它允许AI 代理（如Claude Desktop, Gemini CLI 等）直接与您的Trilium 笔记库互动，执行搜寻、读取、写入和整理笔记等操作。

功能

• 搜寻笔记（search_notes)：透过关键字搜寻笔记。
• 读取笔记（read_note)：读取笔记的内容与基础属性（针对大型笔记进行了优化）。
• 获取笔记元数据（get_note_metadata)：获取完整的笔记属性、标签与关联信息。
• 建立笔记（create_note)：建立新的笔记（支持文字、代码等各种类型）。
• 更新笔记（update_note)：修改现有笔记的内容或属性。
• 移动笔记（move_note)：将笔记移动到新的父节点下。
• 管理属性（manage_attributes)：新增、修改或删除笔记的属性（Attributes）。

安装与设定

1.安装依赖

确保您已安装Node.js (建议v16 以上）。

npm install

2.设定环境变数

在项目根目录建立 .env 档案（可参考 .env.example)：

TRILIUM_ETAPI_URL=http://localhost:8080/etapi
TRILIUM_ETAPI_TOKEN=your_token_here

• TRILIUM_ETAPI_URL：您的Trilium ETAPI 网址。通常是您的Trilium 网址加上 /etapi。
• TRILIUM_ETAPI_TOKEN: 在 Trilium 的 Options -> ETAPI 中建立的 Token。

3.编译项目

npm run build

使用方法

在MCP Client 中设定

以Claude Desktop 或Gemini CLI 为例，请在设定档（如 claude_desktop_config.json 或 settings.json）中加入以下设定：

{
  "mcpServers": {
    "trilium": {
      "command": "node",
      "args": ["/path/to/your/Trilium_MCP/dist/index.js"]
    }
  }
}

注意：

• 请将 /path/to/your/Trilium_MCP/dist/index.js 替换为您实际的档案路径。
• 程式会自动读取项目目录下的 .env 档案，因此不需要在设定档中重复填写环境变数。

开发

• 编译: npm run build
• 测试联机: npx ts-node test-trilium.ts （需先设定好 .env)

授权

麻省理工学院

关于作者

• 作者：加号设计数位工程有限公司HAO.H
• 网站： 加号设计数位工程有限公司
• 粉丝专页： 加号设计数位工程有限公司
• 电子邮件：info@hjplusdesign.com

我们是设计、建筑与制造产业的外部研发伙伴，专门协助缺乏内部技术团队的公司导入数位工作流程、工具与AI，自动化你的知识与作业流程，以补足团队技能升级的能量。 我们专门解决以下情况：

• 公司有设计与制造能量，但缺乏技术整合的工具与流程
• 团队中没技术人员或团队，却需要自动化或数据串接
• 项目复杂、数据格式多，但缺乏整合经验
• 想导入AI 或BIM，但不知道从哪开始
• 需要项目型的数位顾问或工具开发支持
• 需要处理复杂几何分析建模或BIM项目顾问

更多数位转型咨询与服务内容欢迎与我们联络。