serena-mcp - Serena, умный поиск и правка кода

Что понадобится: менеджер пакетов uv; для части языков отдельные языковые серверы.

Когда звать

• Когда проект большой и агент тратит кучу токенов на чтение целых файлов, чтобы найти одну функцию и все места, где её вызывают.
• Когда нужно переименовать или перенести функцию по всему проекту так, чтобы ничего не сломалось, а не заменой текста.

Что это

Агент без помощников работает с кодом как с текстом. Чтобы найти, где вызывается функция, он ищет строку по всем файлам или читает целые файлы. На большом проекте это долго, дорого по токенам и легко ошибиться.

Serena превращает агента в разработчика с IDE. Она работает на уровне символов: классов, функций, ссылок между ними. Автор пишет, что инструменты Serena (поиск, правка, рефакторинг, отладка) устроены как у IDE, поэтому агент работает быстрее и надёжнее, особенно в больших кодовых базах.

Подключается Serena как обычный MCP-сервер и работает с Claude Code, Codex и другими клиентами. В README автор приводит отзывы самих агентов о ней. Это мнение самих моделей на запрос автора, который он называет непредвзятым. Считай это рекламой: измерением оно не является.

Как она видит код

Есть два способа:

• Языковые серверы - бесплатный режим по умолчанию. README называет больше 40 языков: Python, TypeScript, Go, Rust, Java, PHP, Ruby, C#, Swift и другие. Для некоторых нужны дополнительные программы.
• Плагин для JetBrains - платный (есть пробный период). Он использует анализ кода самой IDE.

Как подключить

Сначала поставь uv, если его нет. Дальше команды из README автора и документации по клиентам.

В Claude Code:

uv tool install -p 3.13 serena-agent
serena init
claude mcp add --scope user serena -- serena start-mcp-server --context claude-code --project-from-cwd

В Codex после установки достаточно команды serena setup codex. Если хочется вручную, документация показывает блок для файла ~/.codex/config.toml:

[mcp_servers.serena]
startup_timeout_sec = 15
command = "serena"
args = ["start-mcp-server", "--project-from-cwd", "--context=codex"]

Если сервер не успевает стартовать, документация для Claude Code советует поднять MCP_TIMEOUT, например до 60000.

Проверка: в Claude Code открой /mcp и убедись, что Serena подключена. Потом попроси найти все места вызова какой-нибудь функции своего проекта. Агент должен вызвать инструменты Serena и не искать текст по файлам.

На что смотреть перед установкой

Первое: Serena правит код. Это не помощник только для чтения. Работай в ветке git и просматривай изменения, как после любого другого агента.

Второе: лицензия двойная. Часть SolidLSP под MIT, само приложение под GPL-3.0-or-later. Из-за этого GitHub не может назвать лицензию репозитория одним названием. Для личного использования это не мешает. Если планируешь класть Serena внутрь коммерческого продукта, прочитай файл LICENSE целиком.

Третье: чужие команды в README могут устареть. Автор прямо говорит не брать команды из каталогов и маркетплейсов. Бери из его репозитория и документации.

Мы сверили всё с README, документацией по клиентам и файлом лицензии на 22 октября 2026 года. Serena на этой странице не запускали. Если у тебя большой проект и ты хочешь снизить расход токенов на поиск по коду, начни с неё; про подключение серверов в целом - статья про MCP.