TriliumNext Notes의 MCP 서버

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

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

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

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

빠른 시작

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

• TRILIUM_API_URL (기본값: http://localhost:8080/etapi )

• TRILIUM_API_TOKEN (필수, Trilium Notes 설정에서 가져오세요)

Related MCP server: MCP TriliumNext

설치

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