Serena·oraios
Serena MCP — подключение и инструкция
Serena предоставляет агенту семантическую навигацию и редактирование кода на уровне символов, подобно инструментам IDE.
Что умеет этот сервер
Serena предоставляет агенту семантическую навигацию и редактирование кода на уровне символов, подобно инструментам IDE.
Проект использует language server или JetBrains backend.
Инициализируй один проект и найди символ, его определение и ссылки.
Задача для знакомства
Используй Serena для этого проекта. Найди определение указанного символа и все ссылки на него, затем предложи минимальный план правки. Пока не меняй код.
Уточнить результат
Проверь корень проекта, backend и статус language server. Если символ не находится, сначала проверь индексирование и зависимости, а не заменяй весь поиск текстовым догадками.
Как подключить
Выберите подходящий способПодключить Serena MCP
Установи uv tool install -p 3.13 serena-agent, затем выполни serena init. Для JetBrains выбери отдельный backend по документации. Подключение к Claude Code, Codex или Desktop настрой по Client Guide, не по старой marketplace-команде.
Что понадобится
- uv и окружение для поддерживаемых языков. Текущий README устанавливает serena-agent с Python 3.13; дополнительные требования языка смотри в Language Support.
- 01
Подготовь окружение
uv и окружение для поддерживаемых языков. Текущий README устанавливает serena-agent с Python 3.13; дополнительные требования языка смотри в Language Support.
- 02
Установи и настрой
Установи uv tool install -p 3.13 serena-agent, затем выполни serena init. Для JetBrains выбери отдельный backend по документации. Подключение к Claude Code, Codex или Desktop настрой по Client Guide, не по старой marketplace-команде.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Команда подключения из документации
uv tool install -p 3.13 serena-agent
serena initПервый запрос — пример для чата агента
Используй Serena для этого проекта. Найди определение указанного символа и все ссылки на него, затем предложи минимальный план правки. Пока не меняй код.Как проверить
Проверь корень проекта, backend и статус language server. Если символ не находится, сначала проверь индексирование и зависимости, а не заменяй весь поиск текстовым догадками.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет Serena
Serena предоставляет агенту семантическую навигацию и редактирование кода на уровне символов, подобно инструментам IDE.
Проект использует language server или JetBrains backend. Поиск определения и ссылок помогает ограничить нужный контекст; поддержка конкретного языка зависит от backend и его зависимостей.
Что подготовить перед подключением
uv и окружение для поддерживаемых языков. Текущий README устанавливает serena-agent с Python 3.13; дополнительные требования языка смотри в Language Support.
Как установить и подключить
Установи uv tool install -p 3.13 serena-agent, затем выполни serena init. Для JetBrains выбери отдельный backend по документации. Подключение к Claude Code, Codex или Desktop настрой по Client Guide, не по старой marketplace-команде.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Инициализируй один проект и найди символ, его определение и ссылки. Только после проверки выбери небольшое изменение. Подтверди его diff и тестом соответствующего языка.
Как проверить результат и решить проблемы
Проверь корень проекта, backend и статус language server. Если символ не находится, сначала проверь индексирование и зависимости, а не заменяй весь поиск текстовым догадками.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
Serena не гарантирует корректность рефакторинга. Работа зависит от поддержки языка и актуальности проекта; автор отдельно предупреждает об устаревших командах из MCP-marketplace.
Исходники и документация
Репозиторий: oraios/serena. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.