ergut/mcp-logseq

해결하는 문제

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

작동 방식

이 서버는 MCP 호환 클라이언트(예: Claude Desktop 또는 Claude Code)와 LogSeq HTTP API 간의 브리지 역할을 합니다. 페이지 및 블록 조작을 위한 16개의 핵심 도구를 노출하며, Logseq DSL 쿼리 실행 및 네임스페이스 관리 기능도 포함되어 있습니다.

선택적 고급 기능은 다음과 같습니다:

• 의미론적 벡터 검색: 로컬(Ollama) 또는 호스팅된(OpenAI) 임베딩을 LanceDB와 함께 사용하여 단순한 키워드가 아닌 의미를 기준으로 노트를 찾습니다.
• 접근 제어: 제외된 태그나 특정 네임스페이스 허용/거부 목록을 기반으로 콘텐츠를 필터링하여 개인 노트를 AI에게 숨깁니다.
• DB 모드 지원: Logseq의 DB 모드 그래프 사용자를 위해 클래스 속성 읽기 및 쓰기를 허용합니다.

대상 사용자

지식 관리를 자동화하고, 노트 전반에 걸쳐 복잡한 분석을 수행하거나, AI를 사용하여 기존 지식 그래프 내에서 직접 콘텐츠를 구성하고 생성하려는 LogSeq 사용자.

주요 기능

• 직접 그래프 상호작용: AI 인터페이스를 벗어나지 않고도 페이지와 블록을 생성, 업데이트, 삭제 및 이름 변경할 수 있습니다.
• 스마트 Markdown 파싱: 표준 Markdown을 Logseq의 기본 중첩 블록 구조로 자동 변환합니다.
• 의미론적 검색: 벡터 데이터베이스와의 선택적 통합을 통해 의미 기반 검색을 제공합니다.
• 개인정보 제어: 태그와 네임스페이스를 사용하여 AI가 볼 수 있는 내용을 세밀하게 제어합니다.
• 유연한 배포: 표준 stdio 통신과 TLS 및 베어러 인증을 갖춘 장기 HTTP 서비스를 모두 지원합니다.