Powers the server backend that implements the MCP protocol endpoints and RESTful API interfaces
Manages automated training schedules for post-ClariVein procedure recovery, creates medical appointment reminders, and synchronizes with mobile devices
Provides CRUD operations, search optimization, indexing, and metadata storage for Obsidian notes in a MongoDB database
Enables reading/writing of markdown files from an Obsidian vault, extracting metadata, managing wikilinks and backlinks, and providing real-time synchronization with file changes
MCP Obsidian Server
Windows 10 환경에서 Cursor AI IDE와 연동되는 MCP(Model Context Protocol) 서버입니다. 이 서버는 Obsidian 노트와 Google Calendar를 연결하여 지식 관리 시스템을 구축합니다.
🚀 주요 기능
- MCP 프로토콜 지원: JSON-RPC 기반 통신으로 Cursor AI IDE와 완벽 연동
- Obsidian 연동: 마크다운 파일 읽기/쓰기, 메타데이터 추출, 실시간 동기화
- Google Calendar 연동: ClariVein 시술 후 체계적인 훈련 일정 자동 생성 및 관리
- 노트 검색: Obsidian 노트 전문 검색
- 실시간 동기화: 파일 변경 감지 및 자동 동기화
- 백링크 처리: Obsidian 위키링크 기반 백링크 자동 생성
🛠 기술 스택
- 언어: TypeScript/JavaScript (Node.js)
- 프레임워크: Express.js
- 외부 API: Google Calendar API
- 파일 감지: Chokidar
- 마크다운 파싱: Gray-matter, Remark
- 로깅: Winston
- 프로토콜: JSON-RPC (MCP)
📁 프로젝트 구조
🔧 설치 및 실행
1. 의존성 설치
Google Calendar 연동을 사용하려면 추가 의존성 설치:
2. 설정 파일 구성
config/server-config.json
파일에서 다음 설정을 확인/수정하세요:
3. 개발 모드 실행
4. 프로덕션 빌드 및 실행
🌐 API 엔드포인트
헬스 체크
MCP 엔드포인트
Google Calendar API 엔드포인트
📋 MCP 메서드
기본 메서드
initialize
: 서버 초기화 및 기능 목록 반환shutdown
: 서버 종료exit
: 프로세스 종료
커스텀 메서드
search_notes
: 노트 검색get_note
: 노트 조회update_note
: 노트 업데이트create_note
: 노트 생성delete_note
: 노트 삭제get_recent_notes
: 최근 노트 조회get_all_notes
: 전체 노트 조회
🔍 구현된 기능
✅ Obsidian Connector
- Vault 스캔: 재귀적 마크다운 파일 스캔
- 메타데이터 추출: Frontmatter, 태그, 링크 파싱
- 실시간 감지: 파일 추가/변경/삭제 자동 감지
- 백링크 처리: 위키링크 기반 백링크 자동 생성
- CRUD 작업: 노트 생성, 읽기, 업데이트, 삭제
- 검색: 제목, 태그, 콘텐츠, 메타데이터 기반 검색
✅ Search Service
- 노트 검색: Obsidian 노트 전문 검색
- 결과 랭킹: 관련성 점수 기반 정렬
- 필터링: 태그별, 날짜별 필터
- 스니펫: 검색 결과 컨텍스트 추출
✅ File Watcher
- 실시간 감지: Chokidar 기반 파일 시스템 감시
- 이벤트 처리: 추가/변경/삭제 이벤트 콜백
- 성능 최적화: 디바운싱 및 폴링 설정
- 에러 처리: 파일 접근 오류 복구
✅ 로깅 시스템
- 다중 출력: 콘솔 및 파일 로깅
- 레벨별 관리: error, warn, info, debug
- MCP 전용: 요청/응답/에러 로깅
- 구조화: JSON 형태 로그 저장
🆕 Google Calendar 연동
- 자동 훈련 일정: ClariVein 시술 후 12주간 체계적 훈련 일정 생성
- 의료 검진 일정: 초음파 검사, 상담 등 의료 일정 자동 추가
- 단계별 운동: 저충격유산소 → 조깅도입 → 연속달리기 → 구조화운동 → 마라톤훈련
- 스마트 알림: 훈련 30분 전, 의료 일정 하루 전 알림
- 진행 추적: 훈련 완료 표시 및 노트 추가
- OAuth2 인증: Google 계정 연동 및 토큰 관리
- 모바일 동기화: Google Calendar 앱과 자동 동기화
🧪 테스트
서버 상태 확인
MCP 초기화 테스트
Google Calendar 연동 테스트
📊 로그
로그는 logs/
디렉토리에 저장됩니다:
combined.log
: 전체 로그error.log
: 에러 로그만
로그 레벨은 config/server-config.json
에서 설정할 수 있습니다.
🔧 개발 가이드
새로운 MCP 메서드 추가
src/types/mcp-types.ts
에 메서드 타입 추가src/server/protocol-handler.ts
에 핸들러 구현registerMethodHandler
로 등록
Obsidian 연동 확장
src/connectors/obsidian-connector.ts
수정src/types/obsidian-types.ts
에 타입 추가
🚨 주의사항
- Obsidian Vault 경로: 설정 파일에서 올바른 Obsidian Vault 경로를 지정해야 합니다
- 파일 권한: Obsidian Vault 디렉토리에 읽기/쓰기 권한이 필요합니다
- 메모리 사용량: 대용량 Vault의 경우 충분한 메모리를 확보하세요
🔄 다음 단계
- MCP 커스텀 메서드 구현
- Cursor AI IDE 연동 설정
- 성능 최적화
- 에러 처리 강화
- 테스트 코드 작성
- 문서화 완성
📄 라이선스
ISC
🤝 기여
이슈와 풀 리퀘스트를 환영합니다.
📖 사용 가이드
- 기본 사용법: USECASE.md 파일을 참조하세요
- Google Calendar 연동: GOOGLE_CALENDAR_INTEGRATION.md 파일을 참조하세요
- 상세 설정 가이드: GOOGLE_CALENDAR_SETUP.md 파일을 참조하세요
📞 지원
문제가 발생하면 GitHub Issues에 등록해 주세요.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Model Context Protocol server that connects Cursor AI IDE with Obsidian notes and MongoDB, creating an integrated knowledge management system with real-time synchronization and search capabilities.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.Last updated -6021Python
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to explore and interact with Cursor IDE's SQLite databases, providing access to project data, chat history, and composer information.Last updated -10Python
- AsecurityAlicenseAqualityA powerful Model Context Protocol framework that extends Cursor IDE with tools for web content retrieval, PDF processing, and Word document parsing.Last updated -89PythonMIT License
- -securityAlicense-qualityThis project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.Last updated -66359JavaScriptMIT License