Private Journal MCP Server
MCP-сервер для приватного журнала Claude: записывает размышления, наблюдения и заметки по проекту локально и ищет по ним смыслом, без внешних запросов
- 457 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Пишет файлы с личными размышлениями и техническими заметками в домашнюю папку и в репозиторий проекта без шифрования
- При первом запуске скачивает и запускает модель эмбеддингов, которая обрабатывает текст всех записей на машине
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/private-journal-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Пишет файлы с личными размышлениями и техническими заметками в домашнюю папку и в репозиторий проекта без шифрования
- При первом запуске скачивает и запускает модель эмбеддингов, которая обрабатывает текст всех записей на машине
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Private Journal MCP Server дает Claude инструмент process_thoughts с шестью необязательными разделами: reflections, observations, project_notes, user_context, technical_insights, world_knowledge. Заметки по проекту пишутся в папку .private-journal внутри репозитория, личные мысли и наблюдения о пользователе уходят в ~/.private-journal в домашней папке. Каждая запись получает временную метку с точностью до микросекунд и YAML-заголовок. Поиск работает инструментом search_journal: запрос на естественном языке превращается в вектор моделью @xenova/transformers и сравнивается с embedding-файлами всех записей. Вся обработка идет на машине, без вызовов внешнего API. Инструмент list_recent_entries показывает последние записи за выбранное число дней, а read_journal_entry открывает конкретный файл по пути из результатов поиска. Сервер запускается через npx без установки: конфигурация MCP указывает команду npx с аргументом github:obra/private-journal-mcp. Переменная PRIVATE_JOURNAL_PATH переносит оба журнала, проектный и личный, в один каталог, что удобно для контейнеров, где обычное определение домашней папки не работает.
Для кого. Для разработчиков, которые хотят, чтобы Claude Code запоминал технические наблюдения и контекст проекта между сессиями и находил их по смыслу запроса, а не по точному совпадению слов.
Подходит, если
- Claude Code за сессию натыкается на техническую деталь проекта, которую стоит помнить в следующей сессии, и для этого нужен инструмент process_thoughts с разделом project_notes
- Нужно найти старую заметку по смыслу, а не по точной фразе: search_journal с лимитом результатов и фильтром по разделам
- Несколько проектов на одной машине, и записи о каждом должны остаться рядом с его репозиторием в .private-journal
- Контейнерная среда без обычной домашней папки: PRIVATE_JOURNAL_PATH задает один путь для проектного и личного журнала
- Нужно посмотреть, что Claude записал за последние дни, через list_recent_entries с фильтром project или user
Не подходит, если
- Нужна общая база знаний команды: журнал пишется локально на одной машине и не синхронизируется между людьми
- Записи должны переживать смену структуры проекта предсказуемо: поиск зависит от embedding-файлов, которые пересчитываются при старте
- Хочется держать заметки в одном файле для ручного редактирования: формат раскладывает их по папкам с датами и отдельными embedding-файлами на каждую запись
- Нужна синхронизация с внешним хранилищем заметок: сервер не отправляет данные ни в один сервис
Пример запроса к агенту
Запиши в приватный журнал, почему мы выбрали такую структуру кэша, и найди мои старые заметки про тестирование этого модуляMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
PRIVATE_JOURNAL_PATH- Переносит и проектный, и личный журнал в один указанный каталог вместо раздельных путей по умолчанию.
Ограничения
Поиск работает только локально через модель @xenova/transformers, поэтому первый запуск тратит время на загрузку модели и построение индекса по всем существующим записям. Журнал не шифруется: файлы лежат в открытом виде в .private-journal и в домашней папке, и доступ к ним получает любой, у кого есть доступ к файловой системе. Папка .private-journal попадает в репозиторий, если ее не добавить в .gitignore, и тогда личные записи уходят в коммит. Сервер не предлагает удаление отдельных записей или их редактирование: единственный способ почистить журнал это стереть файлы вручную.
Как отключить. Удалите запись private-journal из конфигурации MCP-клиента. Папки .private-journal в проекте и ~/.private-journal в домашней директории можно стереть вручную, если записи больше не нужны: сервер их не трогает после удаления из конфигурации.
Частые вопросы
Как поставить Private Journal MCP в Claude Code?
Выполните claude mcp add-json private-journal '{"type":"stdio","command":"npx","args":["github:obra/private-journal-mcp"]}' -s user. Сервер запускается через npx без отдельной установки.
Где хранятся записи журнала?
Заметки о проекте лежат в папке .private-journal внутри репозитория, личные мысли и наблюдения о пользователе уходят в ~/.private-journal. Переменная PRIVATE_JOURNAL_PATH переносит оба журнала в один указанный каталог.
Как работает поиск по журналу, если я не помню точную фразу?
search_journal превращает запрос в вектор локальной моделью @xenova/transformers и сравнивает его с embedding-файлами записей, поэтому находит записи близкие по смыслу, а не только по совпадению слов.
Уходят ли записи журнала куда-то наружу?
Нет. Вся обработка, включая построение векторов для поиска, идет локально на машине, сервер не вызывает внешние API и не синхронизирует файлы с сервисами.
Как убрать журнал проекта из git?
Добавьте .private-journal в .gitignore репозитория. Сервер сам не исключает папку из контроля версий.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMinutes
minutes
Локальный MCP-сервер для памяти о встречах: запись и транскрипция на устройстве в Markdown, поиск истории из Claude Code, Codex, Cursor и других MCP-клиентов
Локальный MCP-сервер для безопасного чтения, поиска и правки заметок в хранилище Obsidian, доступ ограничен корнем хранилища
Obsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
Obsidian MCP
obsidian-mcp
Локальный MCP-сервер для хранилищ Obsidian: читает и правит явно указанные папки с файлами Markdown, Obsidian открывать не нужно
MCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
MCP-сервер на Rust для папки с заметками в Markdown: агент ищет, читает заметки, видит обратные ссылки, теги, задачи и историю версий
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Private Journal MCP Server (эта запись) | нет | не нужна | 457 | |
| MegaMemory | нет | не нужна | 725 | граф сущностей и решений проекта для кодовых агентов, а не личный журнал с разделами о пользователе |
| OpenContext | нет | 1 269 | CLI-хранилище контекста проекта для переиспользования между сессиями, без раздела личных наблюдений |
Коротко о README
Главная страница репозитория описывает четыре инструмента MCP и формат записей с YAML-заголовком и разделами по категориям. Раздел конфигурации показывает одностроку для Claude Code и ручной JSON-фрагмент для других клиентов, а также переменную PRIVATE_JOURNAL_PATH и аргумент командной строки --journal-path. В конце README есть советы, как улучшить поведение Claude через системный промпт, чтобы он чаще обращался к журналу.