Servidor MCP de Trilium para Gemini CLI

Este proyecto proporciona un servidor de Protocolo de Contexto de Modelo (MCP), una habilidad especializada de Gemini y un agente autónomo para gestionar Trilium Notes directamente desde tu terminal utilizando la Gemini CLI.

Características

• Integración completa con ETAPI: Crea, busca, mueve y edita notas usando lenguaje natural.

• Agente autónomo: Un agente dedicado trilium-assistant para tareas organizativas complejas.

• Habilidad especializada: Orientación experta sobre la estructura de árbol de notas y atributos de Trilium.

• Seguro: Utiliza un archivo .env para proteger tus tokens de API.

Related MCP server: Notes MCP Server

🛠️ Configuración e instalación

1. Requisitos previos

• Python 3.10+

• Node.js (para Gemini CLI)

• Trilium Notes (con ETAPI habilitado)

2. Clonar el repositorio

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

3. Instalar dependencias

pip install -r requirements.txt

4. Configurar variables de entorno

Copia el archivo de entorno de ejemplo y rellena los detalles de tu Trilium:

cp .env.example .env

Abre .env y proporciona:

• TRILIUM_SERVER_URL: La URL de tu instancia de Trilium (p. ej., http://localhost:8080).

• TRILIUM_ETAPI_TOKEN: Tu token de ETAPI (generado en Configuración de Trilium > Opciones > ETAPI).

🚀 Uso con Gemini CLI

Inicialización

Simplemente ejecuta gemini dentro del directorio del proyecto. La CLI descubrirá automáticamente el servidor MCP, el agente y la habilidad definidos en la carpeta .gemini/.

Comandos

Uso del agente autónomo

El agente puede manejar tareas de varios pasos, como encontrar una nota y moverla:

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

Uso de herramientas MCP directas

Realiza acciones quirúrgicas directamente:

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

Activación de la habilidad

Obtén asesoramiento experto sobre cómo estructurar tus notas:

activate_skill trilium-notes

📂 Estructura del proyecto

• server.py: La implementación del servidor MCP.

• .gemini/settings.json: Configuración para que la Gemini CLI cargue el servidor.

• .gemini/agents/trilium-assistant.md: La definición del agente autónomo.

• .gemini/skills/trilium-notes/: Conocimiento especializado para flujos de trabajo de Trilium.

🛡️ Seguridad

Este proyecto utiliza un .gitignore para asegurar que tu archivo .env nunca se suba a GitHub. Nunca compartas tu archivo .env ni tu token de ETAPI.

📄 Licencia

MIT