Aletheia — MCP-сервер для Claude Code: что делает и как установить
Хранит контекст проекта с привязкой к конкретным строкам кода и автоматически скрывает устаревшие факты при изменении файлов.
claude mcp add aletheia -- npx -y @firatmio/aletheiaЧто делает Aletheia
Aletheia сохраняет знания агента о проекте в виде Markdown-файлов внутри каталога .aletheia/memories/. Каждая запись содержит механические якоря: имя функции, совпадение строчки или наличие файла на диске. Перед тем как передать запись агенту, сервер проверяет эти факты в текущем дереве файлов.
Проверка выполняется локально без сетевых запросов и генерации эмбеддингов. Если файл или функция перемещены, инструмент отслеживает новое местоположение и помечает статус как [moved]. Если же код изменился и привязка сломалась, факт скрывается из контекста модели, чтобы исключить дезинформацию.
На Windows обновление через go install при запущенном агенте завершится ошибкой из-за блокировки файла aletheia.exe, поэтому процесс ассистента придётся предварительно остановить.
Какие задачи решает
- сохранить контекст между сессиями работы агента
- отсеять устаревшие факты об архитектуре проекта
- направить модель на актуальные строки и функции
- отслеживать перемещение функций между файлами
Примеры запросов агенту
- Проверь сохранённые факты о проекте и открой нужные строки для текущей задачи.
- Сохрани в память архитектурное решение по обработке скидок с привязкой к функции.
- Покажи, какие файлы изменились за прошлую сессию и требуют обновления контекста.
Как установить Aletheia
Командой платформы
claude mcp add aletheia -- npx -y @firatmio/aletheiaКомандой платформы
codex mcp add aletheia -- npx -y @firatmio/aletheiaФайл настроек
{
"mcpServers": {
"aletheia": {
"command": "npx",
"args": [
"-y",
"@firatmio/aletheia"
]
}
}
}Файл настроек
{
"servers": {
"aletheia": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@firatmio/aletheia"
]
}
}
}Командой платформы
gemini mcp add aletheia npx -y @firatmio/aletheiaПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Aletheia
Как установить Aletheia в Claude Code?
Выполните команду claude mcp add aletheia -- npx -y @firatmio/aletheia. Также можно настроить плагин или скомпилировать бинарник через Go.
Что делает Aletheia?
Сервер связывает память ассистента с конкретными строками и файлами в репозитории. При каждом запросе он проверяет актуальность кода и скрывает устаревшие факты.
Требуются ли внешние API или эмбеддинги для проверки памяти?
Нет, проверки выполняются механически по локальной файловой системе без обращения к сети и языковым моделям.
