openchronicle-mcp — MCP-сервер для Claude Code: установка
Хранит долговременную память агента с поиском по смыслу и ключевым словам. Нужен, когда решения проекта должны переживать новые сессии.
claude mcp add openchronicle-mcp -- uvx openchronicle-mcpЧто делает openchronicle-mcp
openchronicle-mcp сохраняет решения, этапы работы и отклонённые варианты между сессиями. Память разделяется по проектам, а поиск объединяет полнотекстовый и семантический подходы. Сервер также умеет разбирать историю Git и готовить сведения о причинах решений в существующем коде.
Один процесс предоставляет REST API и MCP-транспорт через HTTP. Данные хранятся локально; предусмотрены миграции схемы, проверяемые резервные копии и опциональная отправка зашифрованных копий через age и rclone. При сбое провайдера эмбеддингов поиск переходит на FTS5.
В контейнере без OC_API_HOST=0.0.0.0 приложение будет слушать только внутренний адрес, и проброс порта не заработает. Для запуска из исходников нужны Python 3.14+ и зависимости .[mcp,openai]; подключение к Claude Code выполняется по HTTP через http://127.0.0.1:8000/mcp.
Какие задачи решает
- сохранять решения между сессиями агента
- разделять память разных проектов
- искать сведения по смыслу и ключевым словам
- подготовить память из истории Git
- создавать проверяемые резервные копии SQLite
Примеры запросов агенту
- Сохрани решение о выборе SQLite и добавь тег
decisionчерезmemory_save. - Найди в памяти проекта решения о хранении данных через
memory_search. - Разбери историю Git этого репозитория и подготовь сведения для долгосрочной памяти.
Как установить openchronicle-mcp
Командой платформы
claude mcp add openchronicle-mcp -- uvx openchronicle-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from openchronicle-mcp <команда>
Командой платформы
codex mcp add openchronicle-mcp -- uvx openchronicle-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from openchronicle-mcp <команда>
Файл настроек
{
"mcpServers": {
"openchronicle-mcp": {
"command": "uvx",
"args": [
"openchronicle-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from openchronicle-mcp <команда>
Файл настроек
{
"servers": {
"openchronicle-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"openchronicle-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from openchronicle-mcp <команда>
Командой платформы
gemini mcp add openchronicle-mcp uvx openchronicle-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from openchronicle-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о openchronicle-mcp
Как установить openchronicle-mcp в Claude Code?
Выполните claude mcp add openchronicle-mcp -- uvx openchronicle-mcp. Сервер будет добавлен через uvx.
Что делает openchronicle-mcp?
Он хранит память агента между сессиями, связывает записи с проектами и ищет их по тексту и смыслу. Для доступа агент использует MCP-транспорт.
Что произойдёт при сбое провайдера эмбеддингов?
Поиск продолжит работу через FTS5. Состояние деградации показывается в /api/v1/health и инструменте MCP health, а после восстановления провайдера запускается догрузка.
