Serena MCP

oraios/serena· Проверено 12.11.2026· 31,3 тыс.на GitHub

Даёт агенту возможности IDE: искать символы и ссылки на них, переименовывать по всему проекту, менять тело функции целиком. Понимание кода берётся из языковых серверов, поддерживается больше 40 языков.

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

Что сделать до подключения

1

Менеджер пакетов uv

2

Установка: uv tool install -p 3.13 serena-agent, затем serena init

3

Для некоторых языков нужны дополнительные зависимости языкового сервера

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio serena \
  -- serena start-mcp-server --context=ide --project-from-cwd

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

find_symbolищет символ по проекту
get_symbols_overviewпоказывает структуру файла
find_referencing_symbolsнаходит, где используется символ
find_declarationнаходит объявление
find_implementationsнаходит реализации
get_diagnostics_for_fileпоказывает ошибки в файле
replace_symbol_bodyзаменяет определение символа
insert_after_symbolвставляет код после символа
insert_before_symbolвставляет код перед символом
rename_symbolпереименовывает по всему проекту
replace_contentзаменяет текст по регулярке
search_for_patternищет по регулярке
read_fileчитает файл
execute_shell_commandвыполняет команду в терминале
write_memoryсохраняет заметку о проекте
read_memoryчитает заметку
activate_projectоткрывает проект

Что попросить агента

«Активируй текущую папку как проект в Serena»Агент вызовет activate_project, дальше инструменты работают с этим проектом
«Переименуй класс <старое имя> в <новое имя> во всём проекте»Агент найдёт класс через find_symbol и вызовет rename_symbol: языковой сервер поправит все ссылки
«Где используется функция <имя>? Покажи все вызовы»Агент вызовет find_symbol и find_referencing_symbols, файлы целиком читать не будет
«Перепиши тело метода <имя> так, чтобы <что поменять>, и проверь ошибки»Агент вызовет replace_symbol_body, затем get_diagnostics_for_file
«Разберись в структуре модуля <путь> и запиши главное в память проекта»Агент вызовет get_symbols_overview и сохранит заметку write_memory, в следующей сессии прочитает её read_memory

Для каких задач

Переименовать функцию или класс во всех файлах одним вызовом
Найти все места, где используется символ, без чтения файлов целиком
Разобраться в большом незнакомом проекте по структуре символов
Хранить заметки о проекте между сессиями
Проверить ошибки в файле после правки через диагностику языкового сервера

Ограничения

!

Перенос символов и файлов, инлайн, поиск по зависимостям и иерархия типов есть только в платном плагине Serena для JetBrains

!

Сервер выполняет команды в терминале и меняет файлы; полностью защищает только запуск в песочнице

!

Ставить из маркетплейсов MCP не нужно: там устаревшие команды установки

!

Клиенту нужен путь к команде serena; если клиент её не находит, укажите полный путь

Если не работает

Клиент не находит команду serena, хотя в терминале она работает
Укажите в настройках клиента полный путь к исполняемому файлу serena.
Claude Code не дожидается запуска Serena
Увеличьте время ожидания: добавьте export MCP_TIMEOUT=60000 в профиль оболочки.
Агент в Claude Code или VS Code не пользуется инструментами Serena или забывает о них в долгой сессии
Настройте хуки-напоминания из документации Serena для вашего клиента.
В VS Code при глобальной установке проект не активируется сам
В начале каждой сессии пишите «Activate the current dir as project using serena» или подключите Serena к рабочей папке с --project ${workspaceFolder}.
Первый поиск символов в большом проекте идёт долго
Один раз проиндексируйте проект командой serena project index из папки проекта, дальше индекс обновляется сам.

Частые вопросы

Какой context указать для моего клиента?
Для Claude Code — claude-code, для Codex — codex, для Claude Desktop — desktop-app. Для Cursor, Cline, Windsurf и терминальных клиентов подходит ide: так меньше дублей с встроенными инструментами.
Нужно ли платить за Serena?
Бэкенд на языковых серверах бесплатный и включён по умолчанию. Плагин для JetBrains IDE платный, у него есть пробный период.
Как Serena узнаёт, с каким проектом работать?
Флаг --project-from-cwd берёт текущую папку, --project задаёт путь явно. В клиентах с глобальной настройкой попросите агента активировать проект, и он вызовет activate_project.
Почему в Claude Code не видно инструментов для файлов и терминала?
В агентах вроде Claude Code и Codex базовые инструменты Serena выключены: у клиента уже есть свои для файлов, поиска и терминала.
Работает ли сервер из России?
Сервер и языковые серверы работают на вашем компьютере, ключи и аккаунты не нужны.

Похожие серверы