TriliumNext Notes' MCP Server

by tan-yong-sheng
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for interacting with a Trilium Notes instance, enabling note management operations including creating, searching, retrieving, updating, and deleting notes of various types (text, code, file, image, search, book, relationMap, render).

TriliumNext Notes의 MCP 서버

⚠️ 면책 조항: 이 도구는 https://github.com/TriliumNext/Notes/issues/705 의 프로토타입입니다. 개발자용으로만 권장합니다. 이 도구를 사용하기 전에 Trilium 노트를 백업하세요. ⚠️

TriliumNext Notes용 모델 컨텍스트 프로토콜 서버입니다. 이 서버는 MCP를 통해 Trilium Notes 인스턴스와 상호 작용할 수 있는 도구를 제공합니다.

업데이트: TriliumNext v0.92.6 최신 버전 지원

참고: Claude Desktop 대신 VSCode에서 Cline 확장 프로그램과 함께 사용하는 것이 좋습니다.

빠른 시작

먼저 환경 변수를 설정하세요.

설치

1. Claude Desktop과 함께 사용

Claude Desktop 구성 파일에 서버 구성을 추가합니다.

Claude 구성 파일의 mcpServers 개체에 다음 구성을 추가합니다.

개발용(Windows/Linux)

지엑스피1

"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>" } }

로컬 설치(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)

"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>" } }

구성 파일의 위치:

  • 윈도우: %APPDATA%/Claude/claude_desktop_config.json
  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

사용 가능한 도구

서버는 노트 관리를 위해 다음과 같은 도구를 제공합니다.

  • search_notes - 노트 검색
    • 필요 사항: 검색어
    • 선택 사항: fastSearch(전체 텍스트 검색 토글), includeArchivedNotes
  • get_note - ID로 노트 내용 검색
    • 필요 사항: 메모 ID
  • create_note - 새 노트 만들기
    • 필요 사항: 부모 노트 ID, 제목, 유형, 콘텐츠
    • 선택 사항: 코드/파일/이미지 메모에 대한 MIME 유형
    • 지원되는 노트 유형: 텍스트, 코드, 파일, 이미지, 검색, 책, 관계 맵, 렌더링
  • update_note - 기존 노트 업데이트
    • 필요 사항: 메모 ID
    • 선택 사항: 새로운 제목, 새로운 콘텐츠
  • delete_note - 메모 삭제
    • 필요 사항: 메모 ID

개발

서버에 기여하거나 수정하고 싶다면:

# 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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

TriliumNext Notes와의 상호작용을 허용하는 모델 컨텍스트 프로토콜 서버로, 자연어 명령을 통해 노트를 생성, 검색, 수집, 업데이트, 삭제할 수 있는 도구를 제공합니다.

  1. Quick Start
    1. Installation
      1. 1. Using with Claude Desktop
    2. Available Tools
      1. Development
        ID: rzhqu47to6