prelude — MCP-сервер для Claude Code: что делает и как установить
Создаёт машиночитаемую карту репозитория и сохраняет архитектурный контекст в каталоге .context/. Помогает ассистентам точнее находить код и связанные тесты.
claude mcp add prelude -- npx -y prelude-contextЧто делает prelude
Сканирует проект эвристиками на регулярных выражениях без внешних API и эмбеддингов. Поддерживает код на TypeScript, JavaScript, Python, Go и Rust. Результат сохраняется в директории .context/ в виде набора JSON-файлов: стек, граф импортов, принятые решения и правила разработки.
Во время сессии ассистент обращается к серверу, чтобы понять связи между модулями или узнать причину старого архитектурного выбора. Команда поиска подбирает релевантные файлы, показывает прямые импорты и тесты, которые затрагивает изменение. Сервер требует установленный Node.js >= 20.19.
Файлы контекста коммитятся в git, поэтому память проекта сохраняется между сессиями. При расхождении структуры кода и зафиксированного описания проверка prelude diff --check завершается с кодом ошибки.
Какие задачи решает
- находить файлы и релевантные тесты по смыслу задачи
- проверять граф импортов перед изменением модулей
- сохранять архитектурные решения прямо в git
- передавать ограничения проекта между разными сессиями
Примеры запросов агенту
- Найди модули для сохранения правок при обновлении
- Покажи тесты и зависимые файлы для
src/core/merger.ts - Зафиксируй решение об отказе от внешних сетевых вызовов
Как установить prelude
Командой платформы
claude mcp add prelude -- npx -y prelude-contextКомандой платформы
codex mcp add prelude -- npx -y prelude-contextФайл настроек
{
"mcpServers": {
"prelude": {
"command": "npx",
"args": [
"-y",
"prelude-context"
]
}
}
}Файл настроек
{
"servers": {
"prelude": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"prelude-context"
]
}
}
}Командой платформы
gemini mcp add prelude npx -y prelude-contextПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о prelude
Как установить prelude в Claude Code?
Выполните в терминале команду claude mcp add prelude -- npx -y prelude-context. Сервер зарегистрируется через npx.
Что делает MCP-сервер prelude?
Он предоставляет агенту доступ к структурированному описанию кодовой базы и графу связей из папки .context/. Ассистент ориентируется в проекте по фактам, а не только по обычному поиску строк.
Нужны ли внешние API или векторные базы?
Нет. Инструмент сканирует файлы локально с помощью регулярных выражений и не отправляет код во внешние сервисы.
