Servidor MCP de TriliumNext Notes

⚠️ AVISO LEGAL: Este es un prototipo para https://github.com/TriliumNext/Notes/issues/705 . Sugerido solo para desarrolladores. Por favor, crea una copia de seguridad de tus notas de Trilium antes de usar esta herramienta. ⚠️

Un servidor de protocolo de contexto de modelo para TriliumNext Notes. Este servidor proporciona herramientas para interactuar con su instancia de Trilium Notes a través de MCP.

Actualización: compatible con la última versión de TriliumNext v0.92.6

Nota: Se sugiere utilizar con la extensión Cline en VSCode, en lugar de Claude Desktop

Inicio rápido

Asegúrese de configurar primero sus variables de entorno:

• TRILIUM_API_URL (predeterminado: http://localhost:8080/etapi )

• TRILIUM_API_TOKEN (obligatorio, obténgalo de la configuración de Trilium Notes)

Related MCP server: MCP TriliumNext

Instalación

1. Uso con Claude Desktop

Agregue la configuración del servidor a su archivo de configuración de Claude Desktop:

Agregue la siguiente configuración al objeto mcpServers en su archivo de configuración de Claude:

Para desarrollo (en 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>"
  }
}

Para instalación local (en Linux)

"triliumnext-mcp": {
  "command": "npx",
  "args": [
        "-y",
        "triliumnext-mcp"
      ],
   "env": {
    "TRILIUM_API_URL": "http://localhost:8080/etapi",
    "TRILIUM_API_TOKEN": "<YOUR_TRILIUM_API_TOKEN>"
  }
}

Para instalación local (en 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>"
  }
}

Ubicación del archivo de configuración:

• Ventanas: %APPDATA%/Claude/claude_desktop_config.json

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Herramientas disponibles

El servidor proporciona las siguientes herramientas para la gestión de notas:

• search_notes - Buscar entre notas

  • Requiere: consulta de búsqueda

  • Opcional: fastSearch (alternar búsqueda de texto completo), includeArchivedNotes

• get_note - Recupera el contenido de una nota por ID

  • Requiere: ID de nota

• create_note - Crea una nueva nota

  • Requiere: ID de nota principal, título, tipo, contenido

  • Opcional: tipo MIME para notas de código/archivo/imagen

  • Tipos de notas admitidos: texto, código, archivo, imagen, búsqueda, libro, relaciónMapa, render

• update_note - Actualizar una nota existente

  • Requiere: ID de nota

  • Opcional: nuevo título, nuevo contenido

• delete_note - Eliminar una nota

  • Requiere: ID de nota

Desarrollo

Si quieres contribuir o modificar el servidor:

# 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