Gemini CLI用 Trilium MCPサーバー

このプロジェクトは、Gemini CLIを使用してターミナルから直接Trilium Notesを管理するための、Model Context Protocol (MCP) サーバー、専用のGeminiスキル、および自律型エージェントを提供します。

機能

• 完全なETAPI統合: 自然言語を使用してノートの作成、検索、移動、編集を行います。

• 自律型エージェント: 複雑な整理タスクのための専用エージェント trilium-assistant。

• 専門スキル: Triliumのノートツリー構造と属性に関する専門的なガイダンス。

• 安全: .envファイルを使用してAPIトークンを保護します。

Related MCP server: Notes MCP Server

🛠️ セットアップとインストール

1. 前提条件

• Python 3.10以上

• Node.js (Gemini CLI用)

• Trilium Notes (ETAPIが有効であること)

2. リポジトリのクローン

git clone https://github.com/dhiraj-ydv/trilium-mcp.git
cd trilium-mcp

3. 依存関係のインストール

pip install -r requirements.txt

4. 環境変数の設定

環境変数のサンプルファイルをコピーし、Triliumの詳細情報を入力します：

cp .env.example .env

.envを開き、以下を指定します：

• TRILIUM_SERVER_URL: TriliumインスタンスのURL (例: http://localhost:8080)。

• TRILIUM_ETAPI_TOKEN: ETAPIトークン (Triliumの「設定」>「オプション」>「ETAPI」で生成)。

🚀 Gemini CLIでの使用方法

初期化

プロジェクトディレクトリ内で gemini を実行するだけです。CLIは .gemini/ フォルダで定義されたMCPサーバー、エージェント、スキルを自動的に検出します。

コマンド

自律型エージェントの使用

エージェントは、ノートを見つけて移動するといった複数ステップのタスクを処理できます：

@trilium-assistant move my 'Drafts' note into the 'Projects' folder.

直接MCPツールを使用する

直接的な操作を実行します：

mcp_trilium-mcp_create_note title="Meeting Notes" parentNoteId="root" content="Hello World"

スキルの有効化

ノートの構造化方法について専門的なアドバイスを得ます：

activate_skill trilium-notes

📂 プロジェクト構造

• server.py: MCPサーバーの実装。

• .gemini/settings.json: サーバーを読み込むためのGemini CLI設定。

• .gemini/agents/trilium-assistant.md: 自律型エージェントの定義。

• .gemini/skills/trilium-notes/: Triliumワークフローのための専門知識。

🛡️ セキュリティ

このプロジェクトでは .gitignore を使用して、.env ファイルがGitHubにプッシュされないようにしています。.env ファイルやETAPIトークンは絶対に共有しないでください。

📄 ライセンス

MIT