Trilium MCP Server для Gemini CLI

Этот проект предоставляет сервер протокола контекста модели (MCP), специализированный навык Gemini и автономного агента для управления Trilium Notes прямо из вашего терминала с помощью Gemini CLI.

Функции

• Полная интеграция с 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: URL вашего экземпляра Trilium (например, http://localhost:8080).

• TRILIUM_ETAPI_TOKEN: Ваш токен ETAPI (генерируется в Trilium: Настройки > Опции > ETAPI).

🚀 Использование с Gemini CLI

Инициализация

Просто запустите gemini внутри директории проекта. CLI автоматически обнаружит MCP-сервер, агента и навык, определенные в папке .gemini/.

Команды

Использование автономного агента

Агент может выполнять многошаговые задачи, такие как поиск заметки и её перемещение:

@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