ergut/mcp-logseq

해결하는 문제

이 프로젝트는 Claude와 같은 AI 어시스턴트를 LogSeq 지식 기반에 연결하는 Model Context Protocol (MCP) 서버를 제공합니다. 수동으로 노트를 내보내거나 복사할 필요 없이, AI가 직접 LogSeq 그래프 내에서 페이지와 블록을 읽고, 생성하고, 관리할 수 있게 해줍니다.

작동 방식

서버는 MCP 호환 클라이언트와 LogSeq HTTP API 사이의 다리 역할을 합니다. 페이지와 블록 조작을 위한 17개의 핵심 도구와 의미 검색을 위한 3개의 선택적 도구를 제공합니다. AI가 생성한 마크다운을 LogSeq의 네이티브 블록 구조로 자동 변환하는 스마트 마크다운 파서도 포함되어 있으며, 제목, 중첩된 목록, 속성 등이 유지됩니다.

대상 사용자

지식 관리를 자동화하고 싶은 LogSeq 사용자, 노트 간에 복잡한 분석을 수행하고 싶은 사용자, 또는 AI 어시스턴트를 활용해 연구 및 회의 메모를 정리하고 문서화하고 싶은 사용자.

주요 기능

• 완전한 그래프 관리: 페이지와 블록의 목록 조회, 읽기, 생성, 업데이트, 삭제 기능 제공.
• 의미 기반 벡터 검색: 로컬(Ollama) 또는 호스팅(OpenAI) 임베딩을 LanceDB를 통해 사용하여 의미에 기반한 노트 검색을 옵션으로 지원.
• 개별 접근 제어: 민감한 콘텐츠를 AI에서 숨기기 위해 제외 태그 및 네임스페이스 허용/차단 목록을 사용한 세밀한 접근 제어.
• 스마트 마크다운 파싱: AI 생성 마크다운을 구조화된 LogSeq 블록으로 자동 변환. YAML 프론트마터 및 체크박스도 지원.
• DB 모드 지원: Logseq DB 모드 그래프의 클래스 속성 읽기/쓰기 기능을 선택적으로 지원.
• 엔터프라이즈 대응 배포: stdio, Bearer 인증을 지원하는 HTTP 전송, 원격 클라이언트를 위한 TLS를 지원.