codealive-mcp — MCP-сервер для Claude Code: семантический поиск
Подключает ИИ-агента к CodeAlive: поиск по смыслу и по регуляркам в проиндексированных репозиториях, дерево файлов, чтение и связи между артефактами.
claude mcp add --env CODEALIVE_API_KEY=<CODEALIVE_API_KEY> --transport stdio codealive-mcp -- docker run -i --rm -e CODEALIVE_API_KEY ghcr.io/codealive-ai/codealive-mcp:3.0.3Что делает codealive-mcp
Сервер даёт агенту инструменты вроде semantic_search, grep_search, get_file_tree, read_file и get_artifact_relationships. Вместо того чтобы читать файлы наугад, агент сначала ищет нужное место, а потом подтягивает исходники через fetch_artifacts. Для больших репозиториев это заметно меняет ход работы.
Есть и chat — синтез ответа по кодовой базе, но он без состояния и работает медленнее поиска. В README советуют звать его только по явному запросу, а основную работу строить на semantic_search и grep_search; если агент умеет субагентов, лучше поручить поиск отдельному субагенту.
Без ключа CODEALIVE_API_KEY сервер не заработает: его получают в личном кабинете CodeAlive, а в конфиг подставляют через переменную окружения. Локальный запуск идёт через Docker-образ ghcr.io/codealive-ai/codealive-mcp:3.0.3, так что Docker должен быть установлен. Рядом с сервером есть отдельный скилл CodeAlive, который учит агента правильным запросам.
Какие задачи решает
- найти нужный участок кода в большом репозитории, не читая файлы подряд
- отличить поиск по смыслу от поиска по регулярному выражению
- посмотреть дерево файлов выбранного репозитория
- прочитать файл по относительному пути с нужным диапазоном строк
- развернуть граф вызовов и наследования для одного артефакта
Примеры запросов агенту
- Покажи все доступные репозитории
- Найди код аутентификации в сервисе пользователей
- Найди точную регулярку, которая матчит JWT-токены
Как установить codealive-mcp
Командой платформы
claude mcp add --env CODEALIVE_API_KEY=<CODEALIVE_API_KEY> --transport stdio codealive-mcp -- docker run -i --rm -e CODEALIVE_API_KEY ghcr.io/codealive-ai/codealive-mcp:3.0.3Вместо <…> подставьте свои значения
Командой платформы
codex mcp add codealive-mcp --env CODEALIVE_API_KEY=<CODEALIVE_API_KEY> -- docker run -i --rm -e CODEALIVE_API_KEY ghcr.io/codealive-ai/codealive-mcp:3.0.3Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"codealive-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CODEALIVE_API_KEY",
"ghcr.io/codealive-ai/codealive-mcp:3.0.3"
],
"env": {
"CODEALIVE_API_KEY": "<CODEALIVE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"codealive-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CODEALIVE_API_KEY",
"ghcr.io/codealive-ai/codealive-mcp:3.0.3"
],
"env": {
"CODEALIVE_API_KEY": "<CODEALIVE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CODEALIVE_API_KEY=<CODEALIVE_API_KEY> codealive-mcp docker run -i --rm -e CODEALIVE_API_KEY ghcr.io/codealive-ai/codealive-mcp:3.0.3Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о codealive-mcp
Как установить codealive-mcp в Claude Code?
Одной командой: `claude mcp add --env CODEALIVE_API_KEY=<CODEALIVE_API_KEY> --transport stdio codealive-mcp -- docker run -i --rm -e CODEALIVE_API_KEY ghcr.io/codealive-ai/codealive-mcp:3.0.3`. Перед этим получите ключ в кабинете CodeAlive и подставьте его вместо плейсхолдера.
Что делает codealive-mcp?
Даёт агенту доступ к семантическому поиску и анализу кода в проиндексированных репозиториях CodeAlive. Кроме поиска есть чтение файлов, дерево, связи между артефактами и запросы к метаданным.
Что нужно для работы сервера?
Ключ CODEALIVE_API_KEY из кабинета CodeAlive и Docker — образ запускается через docker run. Без ключа сервер не запустится.
