Logseq MCP 도구

AI 어시스턴트에게 Logseq 지식 그래프에 대한 구조화된 액세스를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

개요

이 프로젝트는 Claude와 같은 AI 어시스턴트가 Logseq 지식 기반과 상호 작용할 수 있도록 MCP 서버를 생성합니다. 다음과 같은 도구를 제공합니다.

• 모든 페이지 목록 검색
• 특정 페이지에서 콘텐츠 가져오기
• 유연한 날짜 범위에 대한 저널 요약 생성
• 링크된 페이지 추출 및 연결 탐색

설치

1. 이 저장소를 복제하세요
2. npm, yarn 또는 pnpm을 사용하여 종속성을 설치합니다.

지엑스피1

3. 환경 템플릿을 복사하고 Logseq 토큰을 구성하세요.

구성

이 프로젝트에는 복사하여 .env 로 이름을 바꿀 수 있는 .env.template 파일이 포함되어 있습니다.

Logseq 인증 토큰은 다음과 같은 방법으로 찾을 수 있습니다.

1. Logseq 열기
2. 설정 > 기능 > HTTP API 활성화에서 HTTP API 활성화
3. 설정 > 기능 > HTTP API 인증 토큰에서 인증 토큰 설정

용법

MCP 서버 실행

서버는 다음을 사용하여 시작할 수 있습니다.

클로드와 연결

클로드 데스크탑

Claude MCP 빠른 시작 가이드를 따르세요.

1. 중요 : Homebrew(또는 다른 방법)를 통해 Node.js를 전역적으로 설치하세요.

2. Claude 데스크톱 앱 설치
3. Claude 메뉴를 열고 "설정..."을 선택하세요.
4. 왼쪽 사이드바에서 "개발자"를 클릭한 다음 "구성 편집"을 클릭하세요.
5. claude_desktop_config.json 파일이 열립니다. 해당 내용을 다음과 같이 바꾸세요.

중요: /path/to/your/index.ts index.ts 파일의 정확한 절대 경로로 바꾸세요(예: /Users/username/Code/logseq-mcp-tools/index.ts )

6. 파일을 저장하고 Claude Desktop을 다시 시작하세요.

이제 Claude와 채팅하고 Logseq 데이터를 사용하도록 요청할 수 있습니다.

• "최근 저널 항목 보기"
• "지난주에 쓴 노트를 요약해 주세요"
• "[주제]와 관련된 모든 페이지 찾기"

커서의 클로드

Cursor MCP 설명서를 따르세요:

1. 커서 열기
2. 설정에서 새로운 MCP 서비스 추가
3. 다음 명령을 입력하세요:

4. "Logseq Tools"와 같은 서비스 이름을 지정하세요.

이제 Logseq 데이터와 함께 Cursor에서 Claude를 사용할 수 있습니다.

Anthropic API(일반)의 Claude

Claude API 또는 CLI 도구를 사용하는 경우 다음을 사용하여 MCP 서비스를 추가할 수 있습니다.

사용 가능한 도구

모든 페이지 가져오기

Logseq 그래프의 모든 페이지 목록을 검색합니다.

getPage

특정 페이지의 내용을 가져옵니다.

매개변수:

• pageName : 검색할 페이지의 이름

getJournalSummary

지정된 날짜 범위에 대한 일지 항목 요약을 생성합니다.

매개변수:

• dateRange : "오늘", "이번 주", "지난 달", "올해" 등과 같은 자연어 날짜 범위입니다.

이 도구는 다음을 수행합니다.

• 지정된 범위 내에서 저널 항목을 수집합니다.
• 읽기 쉬운 형식으로 작성하세요
• 참조된 페이지/개념 추출 및 분석
• 가장 자주 참조되는 개념을 보여주세요

페이지 생성

Logseq 그래프에 새 페이지를 만듭니다.

매개변수:

• pageName : 새 페이지의 이름
• content : (선택 사항) 페이지의 초기 콘텐츠

검색페이지

이름으로 페이지를 검색합니다.

매개변수:

• query : 이름으로 페이지를 필터링하기 위한 검색 쿼리

겟백링크스

특정 페이지를 참조하는 모든 페이지를 찾습니다.

매개변수:

• pageName : 백링크를 찾을 페이지 이름

분석그래프

지식 그래프에 대한 포괄적인 분석을 수행합니다.

매개변수:

• daysThreshold : (선택 사항) "최근" 콘텐츠를 다시 살펴볼 일 수(기본값: 30)

특징:

• 자주 참조되는 페이지를 식별합니다.
• 최근 업데이트를 추적합니다
• 페이지 클러스터 및 연결을 검색합니다.
• 미해결 작업 목록
• 필요한 잠재적 업데이트를 제안합니다

지식격차 찾기

지식 그래프를 분석하여 잠재적인 격차와 개선 영역을 파악합니다.

매개변수:

• minReferenceCount : (선택 사항) 고려해야 할 최소 참조 수(기본값: 3)
• includeOrphans : (선택 사항) 분석에 고아 페이지를 포함합니다(기본값: true)

특징:

• 자주 참조되는 누락된 페이지를 식별합니다.
• 확장이 필요한 미개발 페이지를 찾습니다.
• 들어오는 링크가 없는 고아 페이지를 나열합니다.
• 요약 통계를 제공합니다

저널 패턴 분석

시간 경과에 따른 일기 항목의 패턴을 분석합니다.

매개변수:

• timeframe : (선택 사항) 분석할 기간(예: "지난 30일", "올해")
• includeMood : (선택 사항) 기분 패턴이 있는 경우 분석합니다(기본값: true)
• includeTopics : (선택 사항) 주제 패턴 분석(기본값: true)

특징:

• 주제 동향 및 진화
• 기분 패턴 분석
• 습관 추적 통계
• 프로젝트 진행 상황 추적

스마트쿼리

Logseq의 DataScript 기능을 사용하여 자연어 쿼리를 실행합니다.

매개변수:

• request : 찾고자 하는 내용에 대한 자연어 설명
• includeQuery : (선택 사항) 생성된 Datalog 쿼리를 결과에 포함합니다.
• advanced : (선택 사항) 고급 분석 기능 사용

특징:

• 페이지 연결 및 관계
• 콘텐츠 클러스터링
• 작업 진행 분석
• 개념 진화 추적

연결 제안

AI를 사용하여 그래프를 분석하고 흥미로운 연결을 제안합니다.

매개변수:

• minConfidence : (선택 사항) 제안에 대한 최소 신뢰도 점수(0-1, 기본값: 0.6)
• maxSuggestions : (선택 사항) 반환할 제안의 최대 수(기본값: 10)
• focusArea : (선택 사항) 제안을 집중할 주제 또는 영역

특징:

• 페이지 간의 잠재적 연결을 발견합니다.
• 지식 합성 기회를 식별합니다
• 최근 관심사를 기반으로 탐색 경로를 제안합니다.
• 제안에 대한 신뢰도 점수를 제공합니다.

개발

서버는 다음을 사용하여 구축되었습니다.

• 모델 컨텍스트 프로토콜 TypeScript SDK
• 매개변수 검증을 위한 Zod
• 데이터 액세스를 위한 Logseq HTTP API

새로운 도구로 확장하려면 index.ts 에 server.tool() 정의를 추가하세요.

문제 해결

일반적인 문제

Node.js 버전 관리자(fnm, nvm 등)

fnm 또는 nvm과 같은 Node.js 버전 관리자를 사용하는 경우 Claude Desktop은 PATH가 수정된 셸 환경 외부에서 실행되므로 Node.js 바이너리에 제대로 액세스할 수 없습니다.

해결 방법 : Homebrew를 사용하여 시스템 전체 Node.js를 설치하세요.

이렇게 하면 Claude Desktop을 포함한 모든 애플리케이션에서 Node.js를 사용할 수 있습니다.

기본 문제 해결 단계

• Logseq가 HTTP API를 활성화하여 실행 중인지 확인하세요.
• .env 의 인증 토큰이 Logseq에 설정된 토큰과 일치하는지 확인하세요.
• Claude 구성에서 index.ts 파일의 경로가 올바른지 확인하세요.
• 터미널에서 npx tsx index.ts 직접 실행하여 작동하는지 확인하세요.

Claude Desktop에서 로그 보기

실시간으로 로그를 모니터링합니다.

더 자세한 디버깅 정보는 공식 MCP 디버깅 설명서 를 참조하세요.