Logseq MCP Server

# 사용 예시 모음 (Usage Examples) VS Code의 GitHub Copilot과 함께 사용하는 실제 시나리오별 예시 모음입니다. > 💡 **사용 방법**: VS Code에서 `Cmd+I` (Chat) 또는 `Cmd+Shift+I` (Inline Chat)를 눌러 GitHub Copilot을 실행하고 아래 예시를 따라해보세요! --- ## 📚 목차 1. [일상 기록](#1-일상-기록) 2. [프로젝트 관리](#2-프로젝트-관리) 3. [지식 정리](#3-지식-정리) 4. [개발 워크플로우](#4-개발-워크플로우) 5. [검색 및 탐색](#5-검색-및-탐색) ## 1. 일상 기록 ### 시나리오: 매일 아침 루틴 기록 **VS Code Copilot Chat에서:** ``` User: 오늘 할 일 Logseq journal에 기록해줘 - 9:00 팀 스탠드업 - 10:00 MCP 서버 개발 - 14:00 코드 리뷰 - 16:00 문서 작성 Copilot: [logseq_add_journal_entry 자동 실행] ✅ 오늘의 journal에 기록했습니다: - 9:00 팀 스탠드업 - 10:00 MCP 서버 개발 - 14:00 코드 리뷰 - 16:00 문서 작성 ``` **Logseq 확인**: 오늘 날짜 journal 페이지에 자동으로 추가됨 ### 시나리오: 회의 노트 정리 **VS Code에서 회의 내용을 작성한 후:** ``` User: @workspace 이 내용으로 "2024-12-02 팀 회의" 페이지 만들어줘 참석자: Alice, Bob, Charlie 안건: 1. Q4 목표 리뷰 2. 신규 프로젝트 킥오프 3. 리소스 배분 Copilot: [logseq_create_page + logseq_create_block 자동 실행] ✅ "2024-12-02 팀 회의" 페이지를 생성하고 내용을 추가했습니다. 페이지 구조: - 참석자: Alice, Bob, Charlie - 안건 - Q4 목표 리뷰 - 신규 프로젝트 킥오프 - 리소스 배분 ``` ### 시나리오: 주간 회고 **VS Code Copilot Chat:** ``` User: @workspace 이번 주 작업 내용 요약해서 Logseq 회고 페이지 만들어줘 Copilot: [workspace 분석 → Git 커밋 확인 → journal 조회 → 페이지 생성] 📊 이번 주 활동 요약: - 12/02 (월): MCP 서버 개발, 문서 작성 - 12/03 (화): 테스트 코드 작성, 버그 수정 - 12/04 (수): 코드 리뷰, 리팩토링 - 12/05 (목): VS Code 연동 테스트 - 12/06 (금): 배포 준비, 문서 업데이트 ✅ "2024-W49 회고" 페이지를 생성했습니다. 주요 성과: - MCP 서버 1차 개발 완료 - VS Code Copilot 연동 성공 개선점: - 테스트 커버리지 향상 필요 - 문서화 자동화 검토 ```스트 커버리지 향상 필요 - 문서화 자동화 검토 ``` --- ## 2. 프로젝트 관리 ### 시나리오: 새 프로젝트 시작 **VS Code Copilot Chat:** ``` User: @workspace "EGO 프로젝트" 페이지를 Logseq에 만들고 초기 구조 잡아줘 Copilot: [logseq_create_page + 계층적 블록 생성] ✅ "EGO 프로젝트" 페이지를 생성했습니다. ## 📋 프로젝트 개요 - 목적: Context Hub 구현 - 기술 스택: NestJS, MCP, Logseq - 시작일: 2024-12-02 ## 🎯 목표 - [ ] MCP 서버 구현 - [ ] Claude 연동 - [ ] 문서화 ## 📝 관련 문서 - [[Context Hub 개념 설계]] - [[Logseq MCP User Flows]] ## 📅 타임라인 - Phase 1: 기본 구조 (1주) - Phase 2: 핵심 기능 (2주) - Phase 3: 테스트 및 배포 (1주) ``` ### 시나리오: TODO 관리 **VS Code Copilot Chat:** ``` User: EGO 프로젝트에 Logseq TODO 추가해줘 - MCP Tools 구현 - 단위 테스트 작성 - README 업데이트 Copilot: [dev-todo 실행] ✅ EGO 프로젝트에 TODO를 추가했습니다: - TODO MCP Tools 구현 - TODO 단위 테스트 작성 - TODO README 업데이트 --- User: Logseq에서 "MCP Tools 구현" TODO 완료 처리해줘 Copilot: [logseq_update_block 실행] ✅ TODO를 DONE으로 변경했습니다. - DONE MCP Tools 구현 ``` ### 시나리오: 프로젝트 진행 상황 추적 **VS Code Copilot Chat:** ``` User: @workspace EGO 프로젝트 진행 상황을 Logseq에 기록해줘 오늘 완료: - Journal, Page, Block Tools 구현 - Logseq Client 래퍼 작성 - 기본 타입 정의 내일 계획: - Search Tool 구현 - Dev Tool 구현 - 테스트 작성 Copilot: [dev-log-progress 실행] ✅ EGO 프로젝트 페이지에 진행 상황을 기록했습니다. ## 2024-12-02 진행 상황 ### ✅ 완료 - Journal, Page, Block Tools 구현 - Logseq Client 래퍼 작성 - 기본 타입 정의 ### 📅 내일 계획 - Search Tool 구현 - Dev Tool 구현 - 테스트 작성 ``` --- ## 3. 지식 정리 ### 시나리오: 학습 내용 정리 **VS Code Copilot Chat:** ``` User: Logseq에 "NestJS 학습" 페이지 만들고 오늘 배운 내용 정리해줘 - Dependency Injection 패턴 - Module 시스템 - Provider와 Injectable 데코레이터 Copilot: [logseq_create_page + 계층적 블록 생성] ✅ "NestJS 학습" 페이지를 생성했습니다. ## 📚 핵심 개념 ### Dependency Injection (DI) - 의존성을 외부에서 주입받는 패턴 - 테스트 용이성 향상 - 느슨한 결합 ### Module 시스템 - `@Module()` 데코레이터 - providers, imports, exports로 구성 - 관심사 분리 ### Provider와 Injectable - `@Injectable()`: 클래스를 DI 가능하게 만듦 - providers 배열에 등록 - constructor 주입 방식 ## 🔗 관련 링크 - [NestJS 공식 문서](https://nestjs.com) ``` ### 시나리오: 지식 연결 **VS Code Copilot Chat:** ``` User: Logseq에서 "MCP Protocol" 페이지와 "NestJS 학습" 페이지를 서로 연결해줘 Copilot: [logseq_get_page → logseq_create_block with reference] ✅ 두 페이지를 연결했습니다. "MCP Protocol" 페이지에 추가: - 관련 기술: [[NestJS 학습]] "NestJS 학습" 페이지에 추가: - 실전 적용: [[MCP Protocol]] 구현 ``` ### 시나리오: 개념 체계화 **VS Code Copilot Chat:** ``` User: Logseq에 "웹 개발" 페이지 만들고 관련 페이지들 자동으로 정리해줘 Copilot: [logseq_get_all_pages → 필터링 → 계층 구조 생성] ✅ "웹 개발" 페이지를 생성하고 관련 개념을 정리했습니다. ## 🎯 Backend - [[NestJS 학습]] - [[TypeScript 기초]] - [[Node.js 최적화]] ## 🎨 Frontend - [[React 학습]] - [[CSS 레이아웃]] - [[상태 관리]] ## 🔧 Tools - [[MCP Protocol]] - [[Git 워크플로우]] - [[Docker 컨테이너]] ``` --- ## 4. 개발 워크플로우 ### 시나리오: 기능 개발 시작 **VS Code Copilot Chat:** ``` User: @workspace 사용자 인증 기능 구현 계획 세워서 Logseq에 기록해줘 기능: JWT 기반 토큰 인증 구현 Copilot: [workspace 분석 → 구현 계획 생성 → dev-implement-feature] 📋 기능 구현 계획: 사용자 인증 ## 분석 - 요구사항: JWT 기반 인증 - 영향 범위: Auth 모듈, Guards, Middleware - 의존성: @nestjs/jwt, passport ## 구현 계획 1. AuthModule 생성 2. JwtStrategy 구현 3. AuthGuard 작성 4. Login/Register API 구현 5. 테스트 작성 ## 체크리스트 - [ ] AuthModule 설정 - [ ] JWT 설정 파일 - [ ] Strategy 구현 - [ ] Controller 작성 - [ ] 단위 테스트 - [ ] E2E 테스트 - [ ] 문서 업데이트 ✅ EGO 프로젝트에 구현 계획을 기록했습니다. ``` ### 시나리오: 코드 리뷰 **VS Code에서 파일 열고:** ``` User: #file:src/auth/auth.service.ts 이 파일 리뷰하고 주요 개선점을 Logseq에 기록해줘 Copilot: [코드 분석 → 리뷰 → dev-code-review] 🔍 코드 리뷰: auth.service.ts ## ✅ 잘된 점 - 단일 책임 원칙 준수 - 타입 안전성 확보 - 에러 처리 명확 ## ⚠️ 개선 제안 1. 비밀번호 해싱 강도 향상 - bcrypt rounds를 10 → 12로 증가 2. 토큰 만료 시간 설정 필요 - JWT expiresIn 추가 3. 테스트 케이스 추가 - 만료된 토큰 처리 - 잘못된 자격 증명 ## 📝 다음 단계 - 보안 강화 - 테스트 커버리지 향상 - 리프레시 토큰 구현 ✅ 리뷰 내용을 EGO 프로젝트에 기록했습니다. ``` ### 시나리오: 기술 결정 기록 **VS Code Copilot Chat:** ``` User: Logseq에 기술 결정(ADR) 기록해줘 제목: JWT vs Session 기반 인증 결정: JWT 선택 이유: - Stateless 아키텍처 - 마이크로서비스 친화적 - 모바일 앱 지원 용이 Copilot: [dev-decision 실행] ✅ 기술 결정(ADR)을 기록했습니다. ## ADR: JWT vs Session 기반 인증 ### 결정 JWT 기반 인증 선택 ### 컨텍스트 사용자 인증 방식 결정 필요 ### 고려사항 | 방식 | 장점 | 단점 | |------|------|------| | JWT | Stateless, 확장성 | 토큰 취소 어려움 | | Session | 즉시 무효화 가능 | 서버 메모리 사용 | ### 결론 - Stateless 아키텍처 선호 - 마이크로서비스 호환성 - 모바일 앱 지원 ### 후속 조치 - 리프레시 토큰 구현 - 블랙리스트 메커니즘 검토 날짜: 2024-12-02 ``` --- ## 5. 검색 및 탐색 ### 시나리오: 키워드 검색 **VS Code Copilot Chat:** ``` User: Logseq에서 "NestJS" 키워드로 검색해줘 Copilot: [logseq_search 실행] 🔍 검색 결과: "NestJS" (15건) ### 페이지 1. **NestJS 학습** - Module 시스템, DI 패턴 2. **EGO 프로젝트** - 기술 스택: NestJS, MCP, Logseq 3. **웹 개발** - Backend 프레임워크: [[NestJS 학습]] ### 블록 4. "NestJS는 TypeScript 기반..." 5. "@Module() 데코레이터로..." ... ``` ### 시나리오: 참조 관계 탐색 **VS Code Copilot Chat:** ``` User: Logseq에서 "MCP Protocol" 페이지를 참조하는 곳들 찾아줘 Copilot: [logseq_get_page_references 실행] 🔗 "MCP Protocol"을 참조하는 페이지 (5건): 1. **EGO 프로젝트** - "[[MCP Protocol]] 구현 중" 2. **NestJS 학습** - "실전 적용: [[MCP Protocol]]" 3. **개발 로드맵** - "Q4 목표: [[MCP Protocol]] 서버 완성" 4. **2024-12-02 Journal** - "오늘 [[MCP Protocol]] 공부" 5. **웹 개발** - "Tools: [[MCP Protocol]]" ``` ### 시나리오: 그래프 개요 **VS Code Copilot Chat:** ``` User: Logseq 그래프 전체 통계 보여줘 Copilot: [logseq_get_graph_info 실행] 📊 Logseq 그래프 통계 **페이지**: 127개 **블록**: 1,543개 **저널**: 45개 **최근 수정**: - 2024-12-02 Journal (방금 전) - EGO 프로젝트 (5분 전) - NestJS 학습 (1시간 전) **인기 페이지** (참조 많은 순): 1. EGO 프로젝트 (23 참조) 2. NestJS 학습 (17 참조) 3. MCP Protocol (15 참조) ``` --- ## 💡 고급 활용 패턴 ### 패턴 1: 일일 리뷰 자동화 **VS Code Copilot Chat:** ``` User: @workspace 오늘 하루 활동을 분석해서 Logseq에 요약해줘 Copilot: [Git 커밋 히스토리 분석] [logseq_get_today_journal 실행] [관련 페이지 참조 추출] [통계 생성] 📝 2024-12-02 활동 요약 **작성한 블록**: 23개 **수정한 페이지**: 5개 **참조한 페이지**: 8개 **주요 활동**: - [[EGO 프로젝트]]: 진행 상황 업데이트 - [[NestJS 학습]]: DI 패턴 정리 - [[MCP Protocol]]: 서버 개발 **시간 분배**: - 개발: 6시간 - 학습: 2시간 - 문서화: 1시간 ``` ### 패턴 2: 프로젝트 대시보드 **VS Code Copilot Chat:** ``` User: @workspace EGO 프로젝트 현황판을 Logseq에 만들어줘 Copilot: [프로젝트 페이지 분석] [TODO 상태 집계] [최근 활동 요약] [Git 커밋 통계] 📊 EGO 프로젝트 대시보드 (2024-12-02) ## 진행률 - ✅ 완료: 15 tasks - 🔄 진행 중: 3 tasks - 📅 예정: 7 tasks - 전체 진행률: 60% ## 최근 마일스톤 - [2024-12-01] MCP Tools 구현 완료 - [2024-12-02] Claude 연동 성공 ## 다음 마일스톤 - [2024-12-03] 테스트 커버리지 80% 달성 - [2024-12-05] 1차 배포 ## 주간 활동 - 개발 기록: 12건 - 기술 결정: 3건 - 아이디어: 5건 ``` ### 패턴 3: 지식 그래프 확장 **VS Code Copilot Chat:** ``` User: Logseq에서 "TypeScript" 관련 학습 내용을 자동으로 체계적으로 정리해줘 Copilot: [관련 페이지 검색] [계층 구조 분석] [새 인덱스 페이지 생성] ✅ "TypeScript 마스터" 페이지를 생성했습니다. ## 📚 학습 경로 ### 기초 1. [[TypeScript 기초]] - 타입 시스템 - 인터페이스 - 제네릭 ### 중급 2. [[TypeScript 고급 타입]] - Union, Intersection - Conditional Types - Mapped Types 3. [[NestJS 학습]] - 데코레이터 활용 - 타입 안전한 DI ### 고급 4. [[타입 레벨 프로그래밍]] - Template Literal Types - Type Inference ## 🎯 실전 프로젝트 - [[EGO 프로젝트]] - NestJS + TypeScript - [[MCP Protocol]] - 타입 안전한 API ``` --- ## 🎯 VS Code 특화 활용패턴 ### 패턴 4: 커밋 메시지 기반 기록 **Git 커밋 후:** ``` User: @terminal 최근 3개 커밋 메시지 분석해서 Logseq journal에 기록해줘 Copilot: [git log -3 --oneline 분석] [logseq_add_journal_entry 실행] ✅ 오늘의 journal에 기록했습니다: - feat: Add MCP server configuration - fix: Update token handling - docs: Add usage examples ``` ### 패턴 5: 파일 변경 사항 추적 **파일 편집 후:** ``` User: #file:src/main.ts 이 파일의 변경 사항을 Logseq에 기록해줘 Copilot: [파일 diff 분석] [logseq_create_block 실행] ✅ "EGO 프로젝트" 페이지에 기록: ## src/main.ts 변경사항 - MCP 서버 초기화 로직 추가 - 환경 변수 검증 강화 - 에러 핸들링 개선 ``` ### 패턴 6: 코드 리뷰 요청과 기록 **PR 생성 전:** ``` User: @workspace 변경된 파일들을 분석해서 코드 리뷰 체크리스트를 Logseq에 만들어줘 Copilot: [변경 파일 분석] [리뷰 포인트 생성] [logseq_create_page] ✅ "2024-12-02 Code Review" 페이지 생성: ## 리뷰 대상 파일 - [ ] src/tools/journal.tool.ts - [ ] src/logseq/logseq.client.ts - [ ] README.md ## 확인 사항 - [ ] 에러 핸들링 적절한가? - [ ] 타입 안전성 보장되나? - [ ] 테스트 커버리지 충분한가? ``` --- ## 🎯 학습 팁 1. **@workspace 멘션 활용**: 프로젝트 전체 컨텍스트를 Copilot에 제공 2. **#file 멘션**: 특정 파일을 기반으로 작업 3. **@terminal**: 터미널 히스토리 및 출력 활용 4. **점진적 기록**: 작은 단위로 자주 기록 5. **자동화**: 반복 작업은 Copilot 패턴으로 자동화 6. **정기적 리뷰**: 주간/월간 회고로 패턴 발견 --- ## 🚀 다음 단계 - VS Code Copilot Chat 패턴 추가 학습 - 자신만의 워크플로우 만들기 - MCP Tool 확장하기 - 팀과 비슷한 패턴 공유하기 궁금한 점이 있으면 언제든 물어보세요! 💬