Gemini CLI용 Trilium MCP 서버

이 프로젝트는 Gemini CLI를 사용하여 터미널에서 직접 Trilium Notes를 관리하기 위한 모델 컨텍스트 프로토콜(MCP) 서버, 특화된 Gemini 스킬 및 자율 에이전트를 제공합니다.

주요 기능

• 전체 ETAPI 통합: 자연어를 사용하여 노트를 생성, 검색, 이동 및 편집합니다.

• 자율 에이전트: 복잡한 정리 작업을 위한 전용 trilium-assistant 에이전트.

• 특화된 스킬: Trilium의 노트 트리 구조 및 속성에 대한 전문가 가이드.

• 보안: .env 파일을 사용하여 API 토큰을 안전하게 보호합니다.

Related MCP server: Notes MCP Server

🛠️ 설정 및 설치

1. 사전 요구 사항

• Python 3.10+

• Node.js (Gemini CLI용)

• Trilium Notes (ETAPI 활성화됨)

2. 저장소 복제

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

3. 의존성 설치

pip install -r requirements.txt

4. 환경 변수 구성

예제 환경 파일을 복사하고 Trilium 세부 정보를 입력하세요:

cp .env.example .env

.env 파일을 열고 다음을 입력하세요:

• TRILIUM_SERVER_URL: Trilium 인스턴스 URL (예: http://localhost:8080).

• TRILIUM_ETAPI_TOKEN: ETAPI 토큰 (Trilium 설정 > 옵션 > ETAPI에서 생성).

🚀 Gemini CLI 사용법

초기화

프로젝트 디렉토리 내에서 gemini를 실행하기만 하면 됩니다. CLI가 .gemini/ 폴더에 정의된 MCP 서버, 에이전트 및 스킬을 자동으로 검색합니다.

명령어

자율 에이전트 사용

에이전트는 노트를 찾아서 이동하는 것과 같은 다단계 작업을 처리할 수 있습니다:

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

직접 MCP 도구 사용

정밀한 작업을 직접 수행합니다:

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

스킬 활성화

노트 구조화 방법에 대한 전문가 조언을 받으세요:

activate_skill trilium-notes

📂 프로젝트 구조

• server.py: MCP 서버 구현.

• .gemini/settings.json: Gemini CLI가 서버를 로드하기 위한 구성.

• .gemini/agents/trilium-assistant.md: 자율 에이전트 정의.

• .gemini/skills/trilium-notes/: Trilium 워크플로우를 위한 전문 지식.

🛡️ 보안

이 프로젝트는 .gitignore를 사용하여 .env 파일이 GitHub에 푸시되지 않도록 합니다. .env 파일이나 ETAPI 토큰을 절대 공유하지 마세요.

📄 라이선스

MIT