AI导哈

Trilium笔记MCP服务器

为Trilium Notes设计的Model Context Protocol (MCP)服务器，允许AI代理直接与笔记库交互，实现搜索、读取、写入和整理笔记等功能。

  • by h30190
  • TypeScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 h30190/Trilium_MCP

使用说明

Trinium MCP服务器 v1.1.0

英语 | 繁体中文

英语

[！警告] 免责声明和备份警告

此工具（MCP服务器）具有以下权限 写入、修改 你的Trillium笔记。 在使用此工具执行任何操作之前，请确保备份Trinium库。

作者不对因使用此工具而导致的任何数据丢失、损坏或意外后果负责。使用风险自负。

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

特性

  • 搜索备注(search_notes)：按关键字搜索笔记。
  • 阅读备注(read_note)：读取笔记内容和基本元数据（针对大笔记进行了优化）。
  • 获取笔记元数据(get_note_metadata)：获取完整的笔记元数据，包括属性、标签和关系。
  • 创建笔记(create_note)：创建新笔记（支持文本、代码等）。
  • 更新说明(update_note)：修改现有注释内容或属性。
  • 移动笔记(move_note)：将笔记移动到新的父级。
  • 列出孩子(list_children)：列出父注释的所有直接子注释。
  • 删除注释(delete_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 设置）

许可证

麻省理工学院

关于作者

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

  • 具有设计和制造能力但缺乏技术集成工具和流程的公司。
  • 没有技术人员的团队或需要自动化或数据集成的团队。
  • 具有多种数据格式但缺乏集成经验的复杂项目。
  • 想要实施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)：将笔记移动到新的父节点下。
  • 列出子笔记（list_children)：列出某笔笔记下的所有直接子笔记。
  • 删除笔记（delete_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)

授权

麻省理工学院

关于作者

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

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

相关 MCP