Logseq MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides direct integration with Logseq's knowledge base, enabling interaction with Logseq graphs, creating pages, managing blocks, and organizing information programmatically.

  • Supports Markdown as a page format option when creating new pages in Logseq.

  • Supports Org format as a page format option when creating new pages in Logseq.

Logseq MCP 서버

Logseq 지식 기반과 직접 통합되는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 LLM은 Logseq 그래프와 상호 작용하고, 페이지를 생성하고, 블록을 관리하고, 정보를 프로그래밍 방식으로 구성할 수 있습니다.

Claude Desktop과 함께 사용

지엑스피1

사용 가능한 도구

블록 작업

  • logseq_insert_block - Logseq에 새 블록을 만듭니다. 매개변수 :
    • parent_block (문자열): 부모 블록 UUID 또는 페이지 이름
    • content (문자열, 필수): 블록 콘텐츠
    • is_page_block (부울): 페이지 수준 블록으로 생성
    • before (boolean): 부모 블록 앞에 삽입
    • custom_uuid (문자열): 블록에 대한 사용자 지정 UUIDv4
  • logseq_edit_block - 블록 편집 모드로 전환 매개변수 :
    • src_block (문자열, 필수): 블록 UUID
    • pos (숫자): 커서 위치
  • logseq_exit_editing_mode - 편집 모드 종료 매개변수 :
    • select_block (부울): 블록을 선택된 상태로 유지

페이지 작업

  • logseq_create_page - 새 페이지 생성 매개변수 :
    • page_name (문자열, 필수): 페이지 이름
    • properties (객체): 페이지 속성
    • journal (boolean): 저널 페이지로 생성
    • format (문자열): 페이지 형식(markdown/org)
  • logseq_get_page - 페이지 세부 정보 가져오기 매개변수 :
    • src_page (문자열, 필수): 페이지 식별자
    • include_children (부울): 자식 블록 포함
  • logseq_get_all_pages - 모든 페이지 나열 매개변수 :
    • repo (문자열): 저장소 이름

콘텐츠 검색

  • logseq_get_current_page - 활성 페이지/블록 가져오기 매개변수 : 없음
  • logseq_get_current_blocks_tree - 현재 페이지의 블록 계층 구조 매개변수 : 없음
  • logseq_get_editing_block_content - 활성 블록의 콘텐츠 가져오기 매개변수 : 없음
  • logseq_get_page_blocks_tree - 페이지의 블록 구조 가져오기 매개변수 :
    • src_page (문자열, 필수): 페이지 식별자

프롬프트

로그시퀀스 삽입 블록

Logseq 인수에 새 블록을 만듭니다.

  • parent_block : 부모 블록 참조(페이지 이름 또는 UUID)
  • content : 블록 콘텐츠
  • is_page_block : 페이지 수준 블록에 대해 true로 설정합니다.

로그시퀀스_생성_페이지

새로운 Logseq 페이지 생성 인수:

  • page_name : 페이지 이름
  • properties : JSON 형태의 페이지 속성
  • journal : 저널 페이지에 대해 true로 설정

설치

pip 사용하기

pip install mcp-server-logseq

출처에서

git clone https://github.com/dailydaniel/logseq-mcp.git cd logseq-mcp cp .env.example .env uv sync

서버를 실행합니다:

python -m mcp_server_logseq

구성

API 키

  1. Logseq에서 API 토큰 생성: API → 인증 토큰
  2. 환경 변수 설정:
export LOGSEQ_API_TOKEN=your_token_here

또는 명령줄을 통해 전달하세요.

python -m mcp_server_logseq --api-key=your_token_here

그래프 구성

기본 URL: http://localhost:12315 사용자 지정 방법:

python -m mcp_server_logseq --url=http://your-logseq-instance:port

예시

회의록 페이지 만들기

Create new page "Team Meeting 2024-03-15" with properties: - Tags: #meeting #engineering - Participants: Alice, Bob, Charlie - Status: pending

기존 페이지에 작업 블록 추가

Add task to [[Project Roadmap]]: - [ ] Finalize API documentation - Due: 2024-03-20 - Priority: high

첫 번째 블록으로 저널 항목 만들기

Create journal entry for today with initial content: - Morning standup completed - Started work on new authentication system

디버깅

npx @modelcontextprotocol/inspector uv --directory . run mcp-server-logseq

기여하다

Logseq 통합을 강화하기 위한 기여를 환영합니다.

  • 새로운 API 엔드포인트 추가(페이지 링크, 쿼리 지원)
  • 블록 조작 기능 개선
  • 템플릿 지원 추가
  • 오류 처리 향상
-
security - not tested
A
license - permissive license
-
quality - not tested

LLM이 Logseq 지식 그래프와 프로그래밍 방식으로 상호 작용하여 페이지와 블록을 만들고 관리할 수 있는 서버입니다.

  1. Usage with Claude Desktop
    1. Available Tools
      1. Block Operations
      2. Page Operations
      3. Content Retrieval
    2. Prompts
      1. logseq_insert_block
      2. logseq_create_page
    3. Installation
      1. Using pip
      2. From source
    4. Configuration
      1. API Key
      2. Graph Configuration
    5. Examples
      1. Create meeting notes page
        1. Add task block to existing page
        2. Create journal entry with first block
      2. Debugging
        1. Contributing
          ID: 0mdgzmmv3r