MCP-сервер TriliumNext Notes

⚠️ ОТКАЗ ОТ ОТВЕТСТВЕННОСТИ: Это прототип для https://github.com/TriliumNext/Notes/issues/705 . Предлагается только для использования разработчиками. Пожалуйста, сделайте резервную копию своих заметок Trilium перед использованием этого инструмента. ⚠️

Модель сервера контекстного протокола для TriliumNext Notes. Этот сервер предоставляет инструменты для взаимодействия с вашим экземпляром Trilium Notes через MCP.

Обновление: поддержка последней версии TriliumNext v0.92.6

Примечание: рекомендуется использовать с расширением Cline в VSCode вместо Claude Desktop.

Быстрый старт

Обязательно сначала настройте переменные среды:

• TRILIUM_API_URL (по умолчанию: http://localhost:8080/etapi )

• TRILIUM_API_TOKEN (обязательно, получите его в настройках Trilium Notes)

Related MCP server: MCP TriliumNext

Установка

1. Использование с Claude Desktop

Добавьте конфигурацию сервера в файл конфигурации Claude Desktop:

Добавьте следующую конфигурацию к объекту mcpServers в файле конфигурации Claude:

Для локальной установки (в 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>"
  }
}

Для локальной установки (на 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/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>"
  }
}

Расположение файла конфигурации:

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

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

Доступные инструменты

Сервер предоставляет следующие инструменты для управления заметками:

• search_notes - Поиск по заметкам

  • Требуется: поисковый запрос

  • Дополнительно: fastSearch (переключение полнотекстового поиска), includeArchivedNotes

• get_note — Извлечь содержимое заметки по идентификатору

  • Требуется: идентификатор заметки

• create_note - Создать новую заметку

  • Требуется: идентификатор родительской заметки, название, тип, содержание

  • Необязательно: тип MIME для примечаний к коду/файлу/изображению

  • Поддерживаемые типы заметок: текст, код, файл, изображение, поиск, книга, relationMap, рендеринг

• update_note — обновить существующую заметку

  • Требуется: идентификатор заметки

  • Необязательно: новое название, новое содержание

• delete_note - Удалить заметку

  • Требуется: идентификатор заметки

Разработка

Если вы хотите внести свой вклад или изменить сервер:

# 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