TriliumNext NotesのMCPサーバー

⚠️免責事項：これはhttps://github.com/TriliumNext/Notes/issues/705のプロトタイプです。開発者向けとしてのみご使用ください。このツールを使用する前に、Trilium ノートをバックアップしてください。⚠️

TriliumNext Notes用のモデルコンテキストプロトコルサーバー。このサーバーは、MCPを介してTrilium Notesインスタンスと対話するためのツールを提供します。

アップデート: TriliumNext v0.92.6 の最新バージョンをサポート

注: Claude Desktop の代わりに、VSCode の Cline 拡張機能を使用することをお勧めします。

クイックスタート

まず環境変数を設定してください:

• TRILIUM_API_URL (デフォルト: http://localhost:8080/etapi )

• TRILIUM_API_TOKEN (必須、Trilium Notes の設定から取得)

Related MCP server: MCP TriliumNext

インストール

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でノートの内容を取得する

  • 必要条件: ノートID

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

  • 必須: 親ノートID、タイトル、タイプ、コンテンツ

  • オプション: コード/ファイル/画像ノートのMIMEタイプ

  • サポートされているノートの種類: テキスト、コード、ファイル、画像、検索、ブック、リレーションマップ、レンダリング

• update_note - 既存のメモを更新する

  • 必要条件: ノートID

  • オプション: 新しいタイトル、新しいコンテンツ

• delete_note - メモを削除する

  • 必要条件: ノートID

発達

サーバーに貢献したり変更したりしたい場合は:

# 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