Комплексный сервер MCP (Model Context Protocol), предоставляющий Клоду возможности ведения приватного дневника и семантического поиска для обработки мыслей, размышлений и инсайтов.

Особенности

Ведение дневника

• Многосекционное ведение дневника: отдельные категории для размышлений, наблюдений, заметок по проектам, пользовательского контекста, технических инсайтов и мировых знаний
• Двойное хранилище: Заметки о проектах остаются с проектами, личные мысли — в адресной папке пользователя
• Записи с временной меткой: Каждая запись автоматически датирована с микросекундной точностью
• YAML frontmatter: структурированные метаданные для каждой записи

Поиск и открытие

• Семантический поиск: Запросы на естественном языке с использованием локальных вложений ИИ
• Векторное сходство: Найти концептуально связанные элементы, а не только совпадения ключевых слов
• Локальная обработка ИИ: использует @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: