세컨드 브레인 MCP 서버

Obsidian 볼트에 대한 지능적이고 안전한 읽기 전용 액세스를 제공하는 MCP 서버입니다. LLM을 위한 의미론적 검색, 메타데이터 필터링 등을 지원합니다.

주요 기능

• 효율적인 데이터베이스 저장소: 대규모 볼트를 위한 SQLite 기반 인덱싱 및 영구 캐싱

• 메모리 모드 옵션: 소규모 볼트나 개발을 위한 선택적 인메모리 인덱싱

• 의미론적 검색: 퍼지 매칭을 통한 모든 노트의 전문 검색

• 태그 기반 필터링: 계층적 태그를 통한 검색 (예: work/puppet, tech/golang)

• 경로 기반 필터링: 디렉토리 패턴별 필터링 (예: Work/Puppet/**)

• 시간적 쿼리: 생성/수정 날짜별 노트 필터링

• 메타데이터 필터링: 유형, 상태, 카테고리별 필터링

• 노트 검색: 특정 노트의 전체 내용 가져오기

• 스마트 요약: 노트 모음에 대한 요약 생성

• 최근 노트: 최근 수정된 노트에 대한 빠른 액세스

• 아카이브 제어: 검색 시 아카이브된 노트를 선택적으로 포함

• 지식 격차: 볼트 전체의 고립된 위키링크 및 미해결 질문 탐지

• 간격 반복 복습: 주기적인 복습을 위해 링크 중요도에 따라 정렬된 오래된 노트 표면화

• 관련 노트: 공유 링크, 태그, 제목 중복을 통한 점수 기반 관련 노트 발견

• 볼트 그래프: 허브 탐지, 깨진 링크 통계 및 고립된 노트 분석을 포함한 전체 링크 그래프

• 보안: 경로 탐색 보호, 파일 크기 제한, 입력 유효성 검사

Related MCP server: Obsidian MCP Server

볼트 호환성

이 서버는 Obsidian 볼트뿐만 아니라 모든 Markdown 파일 디렉토리와 작동합니다. 파일 시스템에서 순수하게 작동하며 Obsidian 앱에 대한 의존성이 없습니다.

Foam과 함께 사용하기

--vault-path를 Foam 작업 공간 루트로 지정하세요. 구성 변경이 필요 없습니다:

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/foam-workspace"

즉시 작동하는 Foam 기능:

• 그래프 도구에서 해결되는 [[wikilinks]] 및 [[target|aliased links]]

• YAML 프론트매터 태그 (인라인 [tag1, tag2] 및 블록 리스트 스타일 모두)

• 중첩된 태그 계층 (work/backend)

• 하위 폴더 구조 (notes/, journal/, projects/)

• 안전한 기본값으로 인덱싱된 프론트매터가 없는 노트

.vscode/ 폴더는 인덱싱에서 자동으로 제외됩니다.

읽기 전용 설계

이 MCP 서버는 AI 상호 작용 중에 볼트가 안전하게 유지되도록 의도적으로 읽기 전용으로 설계되었습니다. 제공 기능:

• ✅ 노트 검색 및 가져오기

• ✅ 메타데이터 및 경로별 필터링

• ✅ 요약 및 통계 생성

• ❌ 노트 생성 또는 편집 불가

• ❌ 파일 수정 불가

쓰기 작업이 필요한 경우, 내장된 안전 검사가 포함된 전용 Obsidian 플러그인을 고려하세요.

설치

구성 및 설치

원클릭 설치

• VS Code:

• VS Code Insiders:

• Cursor:

수동 설치

설치가 필요 없습니다! npx로 직접 사용하세요:

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

로컬 개발

cd second-brain-mcp
npm install
npm run build
npm link

이 명령어를 통해 서버를 second-brain-mcp로 전역에서 사용할 수 있습니다.

Claude Code 및 Claude Desktop

Claude Code

다음 명령어로 서버를 추가하세요:

claude mcp add second-brain -- npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

Claude Desktop

Claude Desktop 구성 파일에 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/path/to/your/vault"
      ]
    }
  }
}

볼트 구조, CLI 인수 및 구성 예제는 docs/configuration.md를 참조하세요.

전체 MCP API 참조 및 사용 예제는 docs/api.md를 참조하세요.

Claude Code와 함께 사용하기

MCP 구성 파일에 추가하세요.

단일 볼트 구성

macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json 편집 Windows: %APPDATA%\Claude\claude_desktop_config.json 편집

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/ioanniskarasavvaidis/Documents/Obsidian Vault"
      ]
    }
  }
}

다중 볼트 구성

여러 볼트 인스턴스를 구성할 수 있습니다:

{
  "mcpServers": {
    "second-brain-personal": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Personal Vault"
      ]
    },
    "second-brain-work": {
      "command": "npx",
      "args": [
        "-y",
        "@comfucios/second-brain-mcp",
        "--vault-path",
        "/Users/username/Documents/Work Vault"
      ]
    }
  }
}

로컬 개발 설정

npm link를 사용하여 로컬에서 개발하는 경우:

{
  "mcpServers": {
    "second-brain": {
      "command": "second-brain-mcp",
      "args": ["--vault-path", "/path/to/your/vault"]
    }
  }
}

더 많은 쿼리 예제는 docs/examples.md를 참조하세요.

문서

다음 내용은 docs/README.md를 참조하세요:

• API 참조

• 구성 및 CLI 옵션

• 쿼리 예제

• 개발 및 저장소 아키텍처

• 기여 방법

• 의존성

• 아키텍처 및 데이터베이스 스키마

• 보안 및 검색

• 쿼리 예제

• 개발

• 기여 방법

• 의존성

• 라이선스

빠른 시작

npx로 즉시 서버 실행 (설치 불필요):

npx -y @comfucios/second-brain-mcp --vault-path "/path/to/your/vault"

또는 Claude Code/Claude Desktop에 추가하세요 (아래 구성 및 설치 참조).

문제 해결 및 FAQ

일반적인 문제와 해결 방법은 docs/configuration.md를 참조하세요.

검색 가중치 및 점수에 대한 자세한 내용은 docs/search.md를 참조하세요.

보안 기능 및 보호 조치에 대한 자세한 내용은 docs/security.md를 참조하세요.

개발 워크플로우 및 저장소 세부 정보는 docs/development.md를 참조하세요.

기여 가이드라인은 docs/contributing.md를 참조하세요.

저장소 아키텍처

이 서버는 효율적인 인덱싱과 영구 캐싱을 위해 기본적으로 SQLite 데이터베이스 저장소를 사용합니다:

• 데이터베이스 모드 (기본값): 볼트 내의 .second-brain-mcp/notes.db에 인덱싱된 노트를 저장합니다.

  • 영구 인덱싱 (서버 재시작 후에도 유지)

  • 대규모 볼트(1000개 이상의 노트)에 효율적

  • SQLite FTS5를 사용한 전문 검색

  • 낮은 메모리 사용량

• 메모리 모드 (선택 사항): 인메모리 저장을 위해 --use-memory 플래그를 사용하세요.

  • 소규모 볼트(100개 미만의 노트)에 더 빠름

  • 디스크 I/O 오버헤드 없음

  • 개발 및 테스트에 유용

  • 퍼지 검색을 위해 Fuse.js 사용

아키텍처 다이어그램은 docs/architecture.md를 참조하세요. 데이터베이스 스키마는 docs/database-schema.md를 참조하세요.

아키텍처

• src/index.ts: 도구 핸들러가 포함된 MCP 서버 구현

• src/vault.ts: 볼트 인덱싱 오케스트레이션 및 보안 제어

• src/storage.ts: 저장소 인터페이스 추상화

• src/database-storage.ts: SQLite 기반 저장소 구현

• src/memory-storage.ts: Fuse.js를 사용한 인메모리 저장소 구현

• src/storage-factory.ts: 모드 선택을 위한 저장소 팩토리 패턴

• src/config.ts: 기본값이 포함된 구성 관리

• src/types.ts: TypeScript 유형 정의 및 유효성 검사 유틸리티

• src/__tests__/: 핵심 기능에 대한 단위 테스트

전체 프로덕션 및 개발 의존성 목록은 docs/dependencies.md를 참조하세요.

지원

second-brain-mcp가 시간을 절약해 주었다면, GitHub에서 후원하거나 커피 한 잔 사주기를 고려해 주세요.

라이선스

MIT