Hermes → Trilium MCP 安装配置🚀

架构总览

安装路径（标准布局）

/opt/data/
├── mcp/
│   └── Trilium-MCP/          # MCP 服务器（从 github.com/h30190/Trilium_MCP 克隆）
│       ├── dist/index.js       # 编译后入口
│       ├── src/                # TypeScript 源码
│       │   ├── index.ts        # 主入口，dotenv 加载 ../.env
│       │   └── trilium-client.ts  # axios 客户端，第 11 行硬编码 Authorization
│       ├── .env                # ETAPI Token（dotenv 自动读取）
│       ├── node_modules/
│       ├── package.json
│       └── tsconfig.json
├── config.yaml                 # mcp_servers.trilium 配置（含 env 注入）
└── .env                        # Hermes 主环境变量

⚠️ 注意：MCP 仓库名是 Trilium_MCP（下划线），但标准安装目录名是 Trilium-MCP（连字符），config.yaml 的 args 中引用的是目录名。安装后请确认路径一致。

源码细节

入口 (dist/index.js)

// dist/index.js 第 13 行 — dotenv 自动加载 ../.env
dotenv.config({ path: path.resolve(__dirname, "../.env") });
const TRILIUM_ETAPI_TOKEN = process.env.TRILIUM_ETAPI_TOKEN;

环境变量加载优先级

1. config.yaml mcp_servers.trilium.env — Hermes 启动 MCP 子进程时注入环境变量
2. MCP 自带 .env — dotenv 加载（不会覆盖已存在的环境变量）
3. 两者都配了同一个 token。如果某天不一致，config.yaml 的注入优先级更高

Authorization 头格式（⚠️ 踩坑点）

// dist/trilium-client.js 第 8 行 — 直接传 token，无 Bearer 前缀
headers: {
    'Authorization': token,      // ← 裸 token，没有 "Bearer "
    'Content-Type': 'application/json',
},

已验证：atibm.com 这个 Trilium 实例只接受裸 token 格式。

• ✅ Authorization: TaCxTq...5Yo= → 200 OK
• ❌ Authorization: Bearer TaCxTq...5Yo= → 401 NOT_AUTHENTICATED

验证测试（对齐 MCP 实际行为）

# 必须先用 source 加载 .env（终端子进程不会自动读取 .env 文件）
source /opt/data/.env

# ✅ 正确：裸 token，与 MCP 源码一致
curl -s -X GET "https://trilium.atibm.com/etapi/notes/root" \
  -H "Authorization: ${TRILIUM_ETAPI_TOKEN}"

# ❌ 错误：Trilium 实例会返回 401
# curl -H "Authorization: Bearer ${TRILIUM_ETAPI_TOKEN}" ...

一次对话安装

帮我装一下 Trilium MCP，安装到 /opt/data/mcp/Trilium-MCP，用
https://github.com/h30190/Trilium_MCP 这个仓库。装完在 /opt/data/config.yaml
的 mcp_servers 里配上，env 里引 .env 的 TRILIUM_ETAPI_TOKEN 就行。
最后 /restart。

注：安装后记得检查 MCP 自带的 .env 文件中的 token 是否与 /opt/data/.env 一致。

使用方式

🔍 搜索笔记

Hermes agent 直接调用 mcp_trilium_search_notes(query="Docker")
底层自动转为 JSON-RPC: {"method":"tools/call","params":{"name":"search_notes","arguments":{"query":"Docker"}}} → 你无需关心

📖 读取笔记

Hermes agent 直接调用 mcp_trilium_read_note(noteId="ludkdAFlaQi5") — 返回基础元数据（noteId/title/type/mime/date）+ 正文

📋 获取元数据

Hermes agent 直接调用 mcp_trilium_get_note_metadata(noteId="...") — 完整属性/标签/关系/子笔记树

✏️ 创建笔记

Hermes agent 直接调用 mcp_trilium_create_note(parentNoteId="...", title="测试", type="text")

🔄 更新笔记

Hermes agent 直接调用 mcp_trilium_update_note(noteId="...", content="...") — 更新标题/内容/类型/MIME

📂 移动笔记

Hermes agent 直接调用 mcp_trilium_move_note(noteId="...", parentNoteId="...") — ⚠️ 会替换所有父节点，克隆笔记会丢失其他父位置

🏷️ 管理属性

Hermes agent 直接调用 mcp_trilium_manage_attributes(action="create", noteId="...", type="label", name="status", value="done")

故障排查