ergut/mcp-logseq

LogSeq용 MCP 서버 Claude를 LogSeq 지식 기반에 연결하세요. 선택적으로 의미 벡터 검색과 DB 모드 그래프 지원을 통해 페이지를 읽고, 생성하며, 관리할 수 있습니다.

✨ 당신이 할 수 있는 것

LogSeq 지식 기반을 AI 기반 작업 공간으로 전환하세요! 이 MCP 서버는 Claude가 LogSeq 그래프와 원활하게 상호작용할 수 있게 합니다.

🎯 실제 사례

** 📊 지능형 지식 관리**

** 📝 자동 콘텐츠 생성**

** 🔍 스마트 리서치 & 분석**

** 🧠 의미 검색** (선택사항, 벡터 설정 필요)

** 🤝 회의 및 문서 워크플로우**

💡 주요 이점

• 제로 컨텍스트 스위칭: 클로드는 LogSeq 데이터를 직접 다룹니다
• 워크플로우 유지: 콘텐츠를 수동으로 내보내거나 복사할 필요가 없습니다
• 지능형 조직: AI 기반 페이지 생성, 링크 및 검색
• 생산성 향상: 반복적인 지식 작업 자동화
• 의미 벡터 검색 (선택): 로컬 Ollama 또는 호스팅된 OpenAI 호환 임베딩을 사용하여 의미에 따라 노트를 찾음
• DB-모드 지원 (옵트인): Logseq DB 모드 그래프에서 클래스 속성을 읽고 쓰기

---

🚀 퀵 스타트

1단계: LogSeq API 활성화

✨ What You Can Do

Transform your LogSeq knowledge base into an AI-powered workspace! This MCP server enables Claude to seamlessly interact with your LogSeq graphs.

🎯 Real-World Examples

📊 Intelligent Knowledge Management

"Analyze all my project notes from the past month and create a status summary"
"Find pages mentioning 'machine learning' and create a study roadmap"
"Search for incomplete tasks across all my pages"

📝 Automated Content Creation

"Create a new page called 'Today's Standup' with my meeting notes"
"Add today's progress update to my existing project timeline page"  
"Create a weekly review page from my recent notes"

🔍 Smart Research & Analysis

"Compare my notes on React vs Vue and highlight key differences"
"Find all references to 'customer feedback' and summarize themes"
"Create a knowledge map connecting related topics across pages"

🧠 Semantic Search (optional, requires vector setup)

"Find everything I wrote about burnout, even if I didn't use that word"
"What notes relate to my thoughts on deep work?"
"Search across my Dutch and English notes for ideas about productivity"

🤝 Meeting & Documentation Workflow

"Read my meeting notes and create individual task pages for each action item"
"Get my journal entries from this week and create a summary page"
"Search for 'Q4 planning' and organize all related content into a new overview page"

💡 Key Benefits

• Zero Context Switching: Claude works directly with your LogSeq data
• Preserve Your Workflow: No need to export or copy content manually
• Intelligent Organization: AI-powered page creation, linking, and search
• Enhanced Productivity: Automate repetitive knowledge work
• Semantic Vector Search (optional): Find notes by meaning using local Ollama or hosted OpenAI-compatible embeddings
• DB-mode Support (opt-in): Read and write class properties on Logseq DB-mode graphs

---

🚀 Quick Start

Step 1: Enable LogSeq API

1. Settings → Features → Check “Enable HTTP APIs server”
2. Click the API button (🔌) in LogSeq → “Start server”
3. Generate API token: API panel → “Authorization tokens” → Create new

Step 2: Add to your MCP client (No Installation Required!)

Claude Code

claude mcp add mcp-logseq \
  --env LOGSEQ_API_TOKEN=your_token_here \
  --env LOGSEQ_API_URL=http://localhost:12315 \
  -- uv run --with mcp-logseq mcp-logseq

Claude Desktop

Add to your config file (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "mcp-logseq": {
      "command": "uv",
      "args": ["run", "--with", "mcp-logseq", "mcp-logseq"],