Logseq MCP 서버

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

Claude Desktop과 함께 사용

지엑스피1

오류가 있는 경우 0.0.1 버전을 사용하세요.

{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": ["mcp-server-logseq==0.0.1"],
      "env": {
        "LOGSEQ_API_TOKEN": "<YOUR_KEY>",
        "LOGSEQ_API_URL": "http://127.0.0.1:12315"
      }
    }
  }
}

Related MCP server: Logseq MCP Tools

사용 가능한 도구

블록 작업

• 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 엔드포인트 추가(페이지 링크, 쿼리 지원)

• 블록 조작 기능 개선

• 템플릿 지원 추가

• 오류 처리 향상