Logseq MCP Server

AI가 당신의 Logseq 그래프를 직접 읽고 쓸 수 있게 해주는 MCP 서버

Claude와 대화하면서 "오늘 저널에 이거 추가해줘", "지난주에 뭐했는지 찾아봐", "이 페이지랑 연결된 거 다 보여줘"가 가능해집니다.

Why This?

문제: Logseq는 훌륭한 PKM 도구지만, AI 어시스턴트와 연동하려면 매번 복사-붙여넣기가 필요합니다.

해결: 이 MCP 서버를 사용하면:

• Claude가 직접 저널에 기록 (복사-붙여넣기 불필요)

• 과거 기록을 검색하고 요약 (맥락 유지)

• 페이지 간 연결 관계 탐색 (백링크, 그래프)

• 템플릿 기반 저널 자동 생성

Is This For You?

Good fit if you...

• Logseq를 주력 PKM으로 사용 중

• Claude Code나 Claude Desktop을 일상적으로 사용

• AI에게 노트 관리를 위임하고 싶음

• 로컬 파일 기반 Logseq 사용 (Logseq Sync 아님)

Not for you if...

• Logseq Sync 사용 중 (로컬 파일 접근 필요)

• Obsidian 사용자 (다른 MCP 서버 필요)

• 노트에 민감 정보가 많고 AI 접근이 불편함

• 마크다운 외 org-mode 사용 (현재 미지원)

Demo

Features

Quick Start

1. 설치

2. 설정

Claude Code (~/.claude/settings.json):

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

3. 확인

Claude에게 물어보세요: "내 Logseq 페이지 목록 보여줘"

Available Tools

Usage Examples

Logseq Graph Structure

Security

Graph 외부 파일 접근 차단, 입력 검증, DoS 방지 등 보안 강화 적용됨.

Troubleshooting

"LOGSEQ_GRAPH_PATH environment variable is required"

LOGSEQ_GRAPH_PATH 환경변수가 설정되지 않았습니다. 설정 파일에서 경로를 확인하세요.

MCP 서버가 Claude에서 인식되지 않음

1. Claude Code/Desktop 재시작

2. 경로가 절대 경로인지 확인 (/Users/... 형식)

3. npm run build 실행 확인

페이지가 보이지 않음

• journals/, pages/ 폴더에 .md 파일이 있는지 확인

• Logseq Sync가 아닌 로컬 그래프인지 확인

org-mode 파일이 안 읽힘

현재 Markdown만 지원합니다. org-mode 지원은 추후 예정.

Development

Project Structure

Contributing

이슈와 PR 환영합니다!

1. Fork this repo

2. Create feature branch (git checkout -b feature/amazing)

3. Commit changes (git commit -m 'Add amazing feature')

4. Push to branch (git push origin feature/amazing)

5. Open a Pull Request

Ideas for contribution

• org-mode 지원

• Logseq 프로퍼티 검색

• 화이트보드 지원

• 더 나은 그래프 시각화 데이터

License

ISC

Related

• Model Context Protocol

• Logseq

• Claude Code