Triliumnext MCP

🚀 TriliumNext ノート MCP サーバー

⚠️ 重要提示

これは https://github.com/TriliumNext/Notes/issues/705 のプロトタイプです。開発者のみ使用を推奨します。このツールを使用する前に、Trilium ノートをバックアップしてください。

このサーバーは、TriliumNext ノートインスタンスとのインタラクションを行うためのモデルコンテキストプロトコルサーバーです。MCP を通じて Trilium ノートを操作するツールを提供します。

更新：最新の TriliumNext v0.92.6 バージョンをサポートしています。

💡 使用建议

Claude Desktop ではなく、VSCode の Cline 拡張機能の使用をおすすめします。

🚀 クイックスタート

まず、以下の環境変数を設定してください。

• TRILIUM_API_URL（デフォルト: http://localhost:8080/etapi）
• TRILIUM_API_TOKEN（必須。Trilium Notes の設定から取得してください）

📦 インストール

1. Claude Desktop を使用する場合

Claude Desktop の設定ファイルにサーバー設定を追加します。

mcpServers オブジェクトに以下の設定を Claude 設定ファイルに追加します。

開発環境（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 を指定してノート内容を取得します。

  • 必要: ノート ID

• create_note - 新しいノートを作成します。

  • 必要: 親ノート ID、タイトル、タイプ、内容
  • オプション: MIME タイプ（コード/ファイル/画像ノート用）
  • サポートされるノートタイプ: text、code、file、image、search、book、relationMap、render

• update_note - 既存のノートを更新します。

  • 必要: ノート ID
  • オプション: 新しいタイトル、新しい内容

• delete_note - ノートを削除します。

  • 必要: ノート ID

🔧 開発

サーバーに貢献したり、修正を加えたい場合は、以下の手順を実行します。

# リポジトリをクローンする
git clone https://github.com/tan-yong-sheng/triliumnext-mcp.git

# 依存関係をインストールする
npm install

# サーバーをビルドする
npm run build

# 開発時に自動的に再ビルドする
npm run watch

⚠️ 重要提示

Claude Desktop の設定ファイルの場所に合わせて適宜調整してください。