클로드에게 생각, 성찰, 통찰 처리를 위한 개인 저널링 및 의미 탐색 기능을 제공하는 포괄적인 MCP(모델 컨텍스트 프로토콜) 서버입니다.

특징

일기 쓰기

• 다중 섹션 저널링: 성찰, 관찰, 프로젝트 노트, 사용자 맥락, 기술적 통찰, 세계 지식을 위한 별도의 카테고리
• 이중 저장소: 프로젝트 노트는 프로젝트와 함께 보관하고, 개인 생각은 사용자 홈 디렉토리에 보관됩니다
• 타임스탬프 항목: 각 항목은 마이크로초 단위로 자동으로 날짜가 표시됩니다
• YAML 전면 자료: 각 항목에 대한 구조화된 메타데이터

탐색과 발견

• 의미 검색: 로컬 AI 임베딩을 이용한 자연어 쿼리
• 벡터 유사성: 단순한 키워드 일치가 아닌 개념적으로 관련된 항목을 찾습니다
• 로컬 AI 처리: @xenova/변환기 사용 - 외부 API 호출 필요 없음
• 자동 인덱싱: 시작 및 진행 중인 모든 항목에 대해 생성되는 임베딩

프라이버시 및 공연

• 완전 프라이빗: 모든 처리가 로컬에서 이루어지며, 데이터가 기기 밖으로 나가지 않습니다
• 빠른 동작: 최적화된 파일 구조 및 메모리 내 유사도 계산

Private Journal MCP Server

A comprehensive MCP (Model Context Protocol) server that provides Claude with private journaling and semantic search capabilities for processing thoughts, reflections, and insights.

Features

Journaling

• Multi-section journaling: Separate categories for reflections, observations, project notes, user context, technical insights, and world knowledge
• Dual storage: Project notes stay with projects, personal thoughts in user home directory
• Timestamped entries: Each entry automatically dated with microsecond precision
• YAML frontmatter: Structured metadata for each entry

Search & Discovery

• Semantic search: Natural language queries using local AI embeddings
• Vector similarity: Find conceptually related entries, not just keyword matches
• Local AI processing: Uses @xenova/transformers - no external API calls required
• Automatic indexing: Embeddings generated for all entries on startup and ongoing

Privacy & Performance

• Completely private: All processing happens locally, no data leaves your machine
• Fast operation: Optimized file structure and in-memory similarity calculations
• Robust fallbacks: Intelligent path resolution across platforms

Installation

This server is run directly from GitHub using npx - no installation required.

MCP Configuration

Claude Code (One-liner)

claude mcp add-json private-journal '{"type":"stdio","command":"npx","args":["github:obra/private-journal-mcp"]}' -s user

Manual Configuration

Add to your MCP settings (e.g., Claude Desktop configuration):

{
  "mcpServers": {
    "private-journal": {
      "command": "npx",
      "args": ["github:obra/private-journal-mcp"]
    }
  }
}

The server will automatically find a suitable location for the journal files.

Configuration

PRIVATE_JOURNAL_PATH environment variable

Set PRIVATE_JOURNAL_PATH to override all journal storage to a single directory. This is useful for containerized deployments where the default home directory resolution doesn’t apply:

{
  "mcpServers": {
    "private-journal": {
      "command": "npx",
      "args": ["github:obra/private-journal-mcp"],
      "env": {
        "PRIVATE_JOURNAL_PATH": "/data/journals"
      }
    }
  }
}

When set, both project and user journals are written to the specified path, bypassing all fallback resolution logic.

--journal-path CLI argument

You can also set the project journal path via CLI argument:

npx github:obra/private-journal-mcp --journal-path /path/to/journals

This only overrides the project journal path. The user journal path still resolves via PRIVATE_JOURNAL_PATH or the default home directory logic.

MCP Tools

The server provides comprehensive journaling and search capabilities:

process_thoughts

Multi-section private journaling with these optional categories: