Longhand

Longhand — MCP-сервер сообщества (автор — Wynelson94). Локальная память для Claude Code: 13 инструментов для семантического поиска, воспроизведения файлов и истории Git. Ставится через pip. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
Wynelson94
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
linux, macos, windows
Языки
python

Уровень риска: medium

Локальный архив сессий Claude Code и Codex в SQLite; Windows только через WSL2.

Настройка клиентов

codex
{
    "code": "codex mcp add longhand -- longhand shared-mcp",
    "lang": "bash",
    "verified": "docs"
}

Что умеет

Longhand — постоянная локальная память для Claude Code. Каждая сессия Claude Code пишет JSONL-файл в ~/.claude/projects/, где есть все сообщения, вызовы инструментов, блоки рассуждений и правки файлов с полным содержимым до и после. Longhand читает эти файлы и сохраняет события дословно в локальную базу SQLite. Claude Code через несколько недель удаляет старые файлы сессий, а в архиве Longhand история остаётся и после этого. Сводки моделью не составляются, вызовов API нет, всё хранится на вашей машине.

MCP-сервер даёт клиенту 13 инструментов:

  • Архив: search — семантический поиск с фильтрами по сессии, проекту, инструменту, файлу и типу события; list_sessions — недавние сессии; get_session_timeline — хронология сессии с постраничным выводом; replay_file — восстановление состояния файла на момент времени; get_file_history — все правки файла во всех сессиях; get_stats — статистика хранилища.
  • Проактивная память: recall — нечёткие вопросы на естественном языке о прошлой работе (автор советует начинать с него); recall_project_status — «на чём мы остановились» по проекту с учётом git; find_episodes — пары «проблема → исправление»; list_projects — распознанные проекты; list_plans — все правки файлов планов в ~/.claude/plans/.
  • Git: find_commits — поиск коммитов по сообщению, хешу или ветке.
  • Самовосстановление: reconcile — повторная привязка и загрузка сессий; по умолчанию пробный прогон, изменения — только с fix=true.

Кроме сервера, в пакете есть хуки Claude Code для автоматической загрузки новых сессий, необязательная подстановка прошлого контекста в новые запросы, резервное копирование архива и необязательная маскировка секретов при загрузке.

Кому подойдёт

Тем, кто много работает в Claude Code и хочет спрашивать агента о прошлых решениях и исправлениях: «что мы решили про middleware авторизации на прошлой неделе?». С версии 1.1.0 в тот же архив попадают треды Codex Desktop и Codex CLI. Другие серверы памяти — в категории знания и память.

Установка

Нужен Python 3.10–3.14. Windows не поддерживается — автор советует WSL2.

pip install longhand
longhand setup

longhand setup загружает существующую историю Claude Code, ставит хуки, регистрирует сервер в Claude Desktop и выводит команду для Claude Code. По словам автора, первый раз это занимает около двух минут. Регистрация в Claude Desktop (longhand mcp install) пишет только в путь конфигурации для macOS. Обновление: pip install -U longhand.

Подключение к клиентам

Команды из README. Подробнее — в инструкции как подключить MCP.

claude mcp add longhand -s user -- longhand mcp-server

Для Codex используется отдельный режим shared-mcp — поиск по ключевым словам в общем архиве Claude Code и Codex. Перед ним выполните longhand codex-sync, чтобы загрузить треды Codex. Для Codex Desktop README отсылает к документации по config.toml.

Проверка

После перезапуска клиента спросите агента о недавней сессии — он должен вызвать recall или list_sessions и вернуть данные из архива.

Примеры задач

Где мы остановились по проекту billing-service? Покажи последние коммиты и нерешённые проблемы.
Как мы чинили гонку в очереди задач на прошлой неделе? Покажи исправление.

Риски

  • Чувствительные данные. В архиве дословно хранятся рассуждения, команды и содержимое файлов, включая случайно попавшие секреты. Маскировка секретов по умолчанию выключена: включите её через longhand config --set redact.enabled=true.
  • Изменение настроек Claude Code. longhand hook install добавляет хуки в ~/.claude/settings.json.
  • Изменение архива. reconcile с fix=true перезагружает данные в базу.
  • Единственная копия. Большая часть истории может существовать только в ~/.longhand/longhand.db — подумайте о longhand backup.

Частые вопросы

Отправляются ли данные в облако?

Нет, по README всё хранится локально и вызовов API нет.

Работает ли на Windows?

Нет, только через WSL2.

Нужен ли ключ API?

Нет.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Memory

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники