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`.
Настройка клиентов
{
"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.
{
"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.
Time
Эталонный сервер для получения текущего времени и перевода между часовыми поясами.
Reactive Resume
Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.
AIHOT
Новости ИИ на китайском: темы, события и сводки.