cursor-history-mcp

cursor-history-mcp — MCP-сервер сообщества (автор — S2thend). Просмотр, поиск, экспорт и резервное копирование истории чатов Cursor. Лицензия MIT.

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

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

Разработчик
S2thend
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

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

Найденная история уходит в MCP-клиент и может попасть к удалённой модели; секреты не вырезаются. `restore` и `migrate` меняют историю, перенос по умолчанию удаляет исходную сессию — сначала сделайте backup и используйте `dryRun`.

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

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"cursor-history\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"cursor-history-mcp@0.3.1\"\n      ]\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Cursor History MCP даёт ИИ-ассистенту искать по истории ваших чатов в Cursor. В старых разговорах часто лежат месяцы решений, найденных багов и архитектурных договорённостей. Сервер читает локальную историю Cursor через библиотеку cursor-history и отдаёт её ассистенту по запросу. Эмбеддинги, отдельный сервис индексации и API-ключ не нужны.

  • cursor_history_list — список сессий с ID, источником и состоянием данных.
  • cursor_history_show — сообщения выбранной сессии.
  • cursor_history_search — поиск текста по истории с соседними строками контекста и фильтром по проекту.
  • cursor_history_export — выгрузка сессии в Markdown или JSON.
  • cursor_history_backup и cursor_history_restore — архив истории Composer и восстановление из него.
  • cursor_history_migrate — перенос или копирование сессий Composer в другой проект, есть пробный режим dryRun.
  • cursor_history_year_pack — итоги года: статистика активности, темы и шаблон отчёта.

Поддерживаются разные форматы хранения Cursor: старые базы Composer, транскрипты агента, хранилище Agent CLI и сессии ACP.

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

  • Тем, кто давно работает в Cursor: «мы уже чинили эту ошибку авторизации?» — ассистент найдёт прошлое обсуждение.
  • Тем, кто переносит проекты: перенос и копирование сессий между папками.
  • Тем, кто хочет подвести итоги года: статистика и темы по истории запросов.

Сервер подключается не только к Cursor, но и к Claude Code и Claude Desktop. Подробнее о самом редакторе — на странице клиента Cursor.

Установка

Нужен Node.js 20.x или 22.x–26.x и доступ к локальной истории Cursor на той же машине. Сервер запускается через npx:

npx -y cursor-history-mcp@0.3.1

Если история лежит в нестандартном месте, задайте переменные CURSOR_DATA_PATH и CURSOR_STORE_ROOT. Для разработки сервер можно собрать из исходников командами npm ci и npm run build.

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

Команда и конфиги приведены дословно из README: для Cursor и Claude Desktop README предлагает добавить одну и ту же запись. Общий порядок — в инструкции как подключить MCP.

.cursor/mcp.json
{
  "mcpServers": {
    "cursor-history": {
      "command": "npx",
      "args": ["-y", "cursor-history-mcp@0.3.1"]
    }
  }
}

Проверка

Попросите: «Найди в моей истории Cursor обсуждения про connection pool». Ассистент должен вызвать cursor_history_search и показать подходящие сессии с UUID.

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

Найди в истории Cursor, как мы решали ошибку авторизации, и расскажи, какие решения тогда приняли.
Выгрузи эту сессию в JSON вместе с данными об источнике.
Сделай итоги моего 2025 года в Cursor.

Риски

Сервер читает локальную историю, но найденный текст попадает в MCP-клиент и может уйти удалённой модели. Результаты не очищаются от секретов автоматически. README предупреждает: в старых разговорах могут быть команды, учётные данные или вредоносный текст, относитесь к ним как к справке, а не к инструкциям.

Инструменты restore и migrate меняют историю, а перенос по умолчанию работает в режиме move и удаляет исходную сессию. Как снизить риски: сначала сделайте резервную копию через cursor_history_backup, закройте Cursor перед записью, запускайте перенос с dryRun. Лицензия — MIT.

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

Нужен ли API-ключ или индексация?

Нет. Сервер читает локальные файлы истории Cursor напрямую, без эмбеддингов и внешних сервисов.

Записывает ли сервер мои новые чаты?

Нет. Он только читает уже существующую историю и не ведёт свою базу разговоров.

Можно ли потерять историю?

Чтение безопасно. Восстановление и перенос меняют данные, поэтому перед ними делайте резервную копию.

Основы протокола — на странице что такое MCP-сервер, другие серверы — в категории разработка.

Инструменты

  • cursor_history_list
  • cursor_history_show
  • cursor_history_search
  • cursor_history_export
  • cursor_history_year_pack
  • cursor_history_backup
  • cursor_history_restore
  • cursor_history_migrate

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

Everything

Эталонный тестовый сервер, который демонстрирует все возможности протокола MCP.

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

Time

Эталонный сервер для получения текущего времени и перевода между часовыми поясами.

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

Reactive Resume

Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.

Риск: medium Лицензия: MIT ★ 45 567

AIHOT

Новости ИИ на китайском: темы, события и сводки.

Риск: medium Лицензия: MIT ★ 9 672

Источники