Logseq MCP 도구

이 프로젝트는 AI 에이전트가 로컬 Logseq 인스턴스와 상호 작용할 수 있도록 하는 MCP(Model Context Protocol) 도구 세트를 제공합니다.

설치

Logseq에 API가 활성화되어 있는지 확인하세요.
- Logseq에서 설정 > 고급 > 개발자 모드 > 개발자 모드 활성화로 이동합니다.
- 그런 다음 플러그인 > Logseq 개발자 플러그인 켜기로 이동하세요.
- 고급 설정에서 API 토큰도 설정하세요
- Logseq 재시작
Cursor MCP 구성 파일(일반적으로 ~/.cursor/mcp.json )에서 MCP 서버를 구성합니다.
{ "mcpServers": { "logseq": { "command": "/opt/homebrew/bin/uvx", "args": ["logseq-mcp"], "env": { "LOGSEQ_API_URL": "http://localhost:12315", "LOGSEQ_TOKEN": "your-token-here" } } } }

Cursor에서 Claude를 사용하는 경우 다음과 유사한 프롬프트를 통해 Logseq 도구를 사용할 수 있음을 알려야 합니다.

"Logseq 그래프와 상호 작용하는 데 도움이 되는 Logseq 도구를 이용하실 수 있습니다. logseq.get_all_pages(), logseq.get_page(name), logseq.create_page(name) 등의 함수를 사용하실 수 있습니다."

모든 도구는 logseq 네임스페이스에서 사용할 수 있습니다.

Logseq의 저널 페이지에는 특정 형식과 속성이 있습니다.

저널 페이지를 만들거나 액세스할 때 "mmm dth, yyyy"(예: "2025년 4월 4일") 형식을 사용하세요.
저널 페이지는 적절한 날짜로 Logseq에 의해 자동으로 포맷됩니다.
저널 페이지에는 Logseq에서 자동으로 설정되는 특수 속성이 있습니다.
- journal? : true - 이것이 저널 페이지임을 나타냅니다.
- journalDay : YYYYMMDD - 숫자 형식의 날짜(예: 2025년 4월 4일의 경우 20250404)
예: await logseq.create_page("Apr 4th, 2025")

중요: journal? 또는 journalDay 속성을 수동으로 설정할 필요는 없습니다. 적절한 날짜 형식(예: "2025년 4월 4일")으로 페이지를 생성하기만 하면 해당 속성이 적용된 저널 페이지로 자동 설정됩니다.

Logseq의 블록에는 이해해야 할 몇 가지 중요한 특성이 있습니다.

자동 글머리 기호 : 모든 블록은 Logseq UI에서 자동으로 글머리 기호로 렌더링됩니다.
페이지 링크 : 이중 괄호를 사용하여 링크를 만듭니다: [[Page Name]]
계층적 블록 :
- 블록 구조 데이터에는 계층적 정보가 포함되어 있습니다.
  - parent : 부모 블록의 ID
  - level : 들여쓰기 레벨(최상위 레벨의 경우 1, 들여쓰기 블록의 경우 2+)
  - left : 왼쪽 블록(일반적으로 들여쓰기된 블록의 부모)
블록 콘텐츠 : 블록을 만들 때 텍스트 서식을 포함할 수 있습니다.
- 기본 마크다운이 지원됩니다(굵게, 기울임꼴 등)
- 블록 내의 글머리 기호는 지원이 제한될 수 있습니다.
- 다중 줄 콘텐츠가 지원되지만 Logseq의 구문 분석 규칙이 적용될 수 있습니다.
저널 블록 : 저널 페이지에서 생성된 블록은 다음과 같은 특수 속성을 상속합니다.
- journal? : 사실
- journalDay : YYYYMMDD - 저널 페이지와 동일

참고: 저널 페이지와 마찬가지로 이러한 블록 속성은 Logseq에서 자동으로 처리됩니다. 저널 페이지에 블록을 생성할 때 journal? 또는 journalDay 속성을 수동으로 설정할 필요가 없습니다.

Cursor 에이전트 작업: Cursor에 Logseq MCP 도구가 구성된 경우 다음과 같은 프롬프트를 에이전트에 제공할 수 있습니다.

에이전트는 적절한 Logseq 도구를 사용하여 그래프에서 이러한 작업을 수행합니다.