👁 로그시퀀스-mcp-메인

Logseq MCP 도구

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

설치

1. Python 3.11 이상이 설치되어 있는지 확인하세요.

2. 이 저장소를 복제하세요

3. 종속성 설치:

   지엑스피1

Related MCP server: Logseq MCP Tools

설정

1. Logseq에 API가 활성화되어 있는지 확인하세요.

   • Logseq에서 설정 > 고급 > 개발자 모드 > 개발자 모드 활성화로 이동합니다.

   • 그런 다음 플러그인 > Logseq 개발자 플러그인 켜기로 이동하세요.

   • 고급 설정에서 API 토큰도 설정하세요

   • Logseq 재시작

2. 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"
    }
    }
    }
   }

또는

3. MCP 서버를 사용하도록 Claude Code를 구성합니다.

claude mcp add

• 범위 선택

• Stdio 선택

• LOGSEQ_API_URL=http://localhost:12315 LOGSEQ_TOKEN=your-token-here /opt/homebrew/bin/uvx logseq-mcp

커서와 클로드와 함께 사용

커서의 MCP 도구에 추가

1. 위의 설정 섹션에서 표시된 대로 MCP 서버를 구성하세요.

2. 커서를 열고 MCP 패널(사이드바)로 이동합니다.

3. Logseq 도구는 사용 가능한 도구 목록에 나타나야 합니다.

Claude와 함께 사용

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

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

사용 가능한 도구

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

페이지

• logseq.get_all_pages : Logseq 그래프의 모든 페이지 목록을 가져옵니다.

• logseq.get_page : 이름으로 특정 페이지를 가져옵니다.

• logseq.create_page : 새 페이지를 만듭니다

• logseq.delete_page : 페이지와 해당 페이지의 모든 블록을 삭제합니다.

블록

• logseq.get_page_blocks : 특정 페이지의 모든 블록을 가져옵니다.

• logseq.get_block : ID로 특정 블록 가져오기

• logseq.create_block : 페이지에 새 블록을 만듭니다.

• logseq.insert_block : 블록을 다른 블록의 자식으로 삽입합니다.

• logseq.update_block : 기존 블록을 업데이트합니다.

• logseq.move_block : 블록을 다른 위치로 이동합니다.

• logseq.remove_block : 블록과 그 모든 자식을 제거합니다.

• logseq.search_blocks : 쿼리와 일치하는 블록을 검색합니다.

Logseq 작업

저널 페이지

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

1. 저널 페이지를 만들거나 액세스할 때 "mmm dth, yyyy"(예: "2025년 4월 4일") 형식을 사용하세요.

2. 저널 페이지는 적절한 날짜로 Logseq에 의해 자동으로 포맷됩니다.

3. 저널 페이지에는 Logseq에서 자동으로 설정되는 특수 속성이 있습니다.

   • journal? : true - 이것이 저널 페이지임을 나타냅니다.

   • journalDay : YYYYMMDD - 숫자 형식의 날짜(예: 2025년 4월 4일의 경우 20250404)

4. 예: await logseq.create_page("Apr 4th, 2025")

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

블록 구조 및 형식

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

1. 자동 글머리 기호 : 모든 블록은 Logseq UI에서 자동으로 글머리 기호로 렌더링됩니다.

2. 페이지 링크 : 이중 괄호를 사용하여 링크를 만듭니다: [[Page Name]]

3. 계층적 블록 :

   • 블록 구조 데이터에는 계층적 정보가 포함되어 있습니다.

     • parent : 부모 블록의 ID

     • level : 들여쓰기 레벨(최상위 레벨의 경우 1, 들여쓰기 블록의 경우 2+)

     • left : 왼쪽 블록(일반적으로 들여쓰기된 블록의 부모)

4. 블록 콘텐츠 : 블록을 만들 때 텍스트 서식을 포함할 수 있습니다.

   • 기본 마크다운이 지원됩니다(굵게, 기울임꼴 등)

   • 블록 내의 글머리 기호는 지원이 제한될 수 있습니다.

   • 다중 줄 콘텐츠가 지원되지만 Logseq의 구문 분석 규칙이 적용될 수 있습니다.

5. 저널 블록 : 저널 페이지에서 생성된 블록은 다음과 같은 특수 속성을 상속합니다.

   • journal? : 사실

   • journalDay : YYYYMMDD - 저널 페이지와 동일

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

일반적인 작업에 대한 사용 예

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

• "오늘의 일정에 대한 요점을 담은 '회의 메모'라는 새 페이지를 만드세요."

• "오늘의 작업을 '작업' 섹션이 있는 저널 페이지에 추가"

• "[[프로젝트 계획]]으로 오늘의 저널 항목을 업데이트하고, 해당 자식 요소를 '완료된 마일스톤 1'로 설정합니다."

• "내 그래프에서 '파이썬 프로젝트'에 대한 블록을 검색하여 새 페이지에 구성합니다."

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

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• create_blockA
• create_pageA
• delete_pageA
• get_all_pagesA
• get_blockA
• get_pageA
• get_page_blocksA
• get_page_linked_referencesA