ChatCrystal — MCP-сервер для Claude Code: память из истории чатов
Собирает диалоги из Claude, Cursor и Codex CLI, превращает их в заметки и отдаёт агенту через MCP. Пригодится, когда нужно вспомнить, что вы уже решали в проекте.
claude mcp add --env CHATCRYSTAL_BASE_URL=<CHATCRYSTAL_BASE_URL> --env CHATCRYSTAL_API_TOKEN=<CHATCRYSTAL_API_TOKEN> --transport stdio server -- npx -y chatcrystalЧто делает ChatCrystal
ChatCrystal сканирует истории чатов из Claude, Cursor, Codex CLI, Trae и GitHub Copilot, прогоняет их через LLM и складывает в базу структурированных заметок. Дальше по ним работает семантический поиск: crystal search "React state", список заметок по тегам, связи между заметками. Всё локально, данные лежат в ~/.chatcrystal/data.
Для интеграции с редакторами поднимается MCP-сервер командой crystal mcp. Он отдаёт семь инструментов: поиск по заметкам, чтение заметки целиком, постраничный список, связи, а также recall_for_task, validate_task_memory и write_task_memory — последние три нужны, чтобы агент сначала подтягивал память по задаче, проверял её на сухую и только потом записывал новую. Установка глобальная: npm install -g chatcrystal.
Без LLM-провайдера ничего не заработает. Нужен Ollama, OpenAI, Anthropic, Google AI, OrcaRouter или любой OpenAI-совместимый API, плюс Node.js не ниже 20. Провайдер и ключ задаются через crystal config set llm.provider и crystal config set llm.apiKey. Для облачного инстанса в Docker токен сохраняется один раз через crystal connect, а crystal mcp переиспользует это подключение; при заданном CHATCRYSTAL_API_TOKEN в окружении деплоя менять токен нужно через переменную и пересоздание контейнера, а не через token reset.
Какие задачи решает
- найти, что вы уже обсуждали с агентом по конкретному модулю
- превратить длинные сессии в короткие заметки с выводами и сниппетами
- подтянуть память по задаче до того, как агент начнёт писать код
- проверить заметку на сухую перед записью в базу
- разложить накопленные диалоги по тегам и связям
Примеры запросов агенту
- Найди в моей базе заметок всё про состояние React и покажи связи
- Подтяни память по задаче рефакторинга авторизации, потом предложи план
- Проверь эту заметку на сухую и, если пройдёт, сохрани как память по задаче
Как установить ChatCrystal
Командой платформы
claude mcp add --env CHATCRYSTAL_BASE_URL=<CHATCRYSTAL_BASE_URL> --env CHATCRYSTAL_API_TOKEN=<CHATCRYSTAL_API_TOKEN> --transport stdio server -- npx -y chatcrystalВместо <…> подставьте свои значения
Командой платформы
codex mcp add server --env CHATCRYSTAL_BASE_URL=<CHATCRYSTAL_BASE_URL> --env CHATCRYSTAL_API_TOKEN=<CHATCRYSTAL_API_TOKEN> -- npx -y chatcrystalВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"server": {
"command": "npx",
"args": [
"-y",
"chatcrystal"
],
"env": {
"CHATCRYSTAL_BASE_URL": "<CHATCRYSTAL_BASE_URL>",
"CHATCRYSTAL_API_TOKEN": "<CHATCRYSTAL_API_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"chatcrystal"
],
"env": {
"CHATCRYSTAL_BASE_URL": "<CHATCRYSTAL_BASE_URL>",
"CHATCRYSTAL_API_TOKEN": "<CHATCRYSTAL_API_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CHATCRYSTAL_BASE_URL=<CHATCRYSTAL_BASE_URL> -e CHATCRYSTAL_API_TOKEN=<CHATCRYSTAL_API_TOKEN> server npx -y chatcrystalВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ChatCrystal
Как установить ChatCrystal в Claude Code?
Сначала claude mcp add chatcrystal -e CHATCRYSTAL_API_TOKEN=<CHATCRYSTAL_API_TOKEN> -- npx -y chatcrystal. Для варианта с базовым URL: `claude mcp add --env CHATCRYSTAL_BASE_URL=<CHATCRYSTAL_BASE_URL> --env CHATCRYSTAL_API_TOKEN=<CHATCRYSTAL_API_TOKEN> --transport stdio server -- npx -y chatcrystal`.
Что делает ChatCrystal?
Импортирует истории чатов из AI-редакторов, суммаризирует их в заметки и отдаёт агенту через MCP-инструменты: поиск, чтение заметки, связи, память по задаче.
Что нужно для работы?
Node.js 20 или новее и доступ к LLM: Ollama, OpenAI, Anthropic, Google AI, OrcaRouter или любой OpenAI-совместимый API. Провайдер и ключ задаются через crystal config set.
