Serena MCP — MCP-сервер для Claude Code: семантика кода
Даёт агенту доступ к символам, ссылкам и рефакторингу через language servers. Пригодится на больших проектах, где поиск по строкам уже не работает.
claude mcp add serena -- uvx serena-agentЧто делает Serena MCP: the IDE for your agent
Serena подключается к вашему ИИ-клиенту по Model Context Protocol и добавляет инструменты для работы с кодом на уровне символов, а не строк. Агент находит определения, ссылки и делает переименования через несколько файлов одним вызовом. Внутри — слой абстракции над language servers, которые реализуют LSP. Заявлена поддержка более 40 языков, включая Python, TypeScript, Go, Rust, Java и C/C++.
Есть и второй бэкенд — платный плагин Serena для JetBrains с бесплатным пробным периодом, он опирается на анализ кода в самой IDE. Выбор между ними зависит от того, готовы ли вы платить за более глубокий разбор. По умолчанию работает вариант с language servers.
Сервер запускается командой uvx serena-agent, поэтому uvx должен быть в системе. Подключить можно двумя способами: дать клиенту команду запуска или поднять сервер самому в HTTP-режиме и передать клиенту URL. Второй вариант удобнее, если клиентов несколько.
Какие задачи решает
- найти все ссылки на функцию перед переименованием
- переименовать символ сразу в нескольких файлах
- перейти к определению метода в чужом модуле
- разобраться в зависимостях большого монорепозитория
- заменить поиск по строкам на работу с символами
Примеры запросов агенту
- найди все места, где вызывается
parse_config, и покажи их - переименуй класс
UserStoreвAccountStoreпо всему проекту - покажи, откуда импортируется модуль
auth.tokens
Как установить Serena MCP: the IDE for your agent
Командой платформы
claude mcp add serena -- uvx serena-agentuvx запускает команду с именем пакета; если в README она другая — uvx --from serena-agent <команда>
Командой платформы
codex mcp add serena-mcp-the-ide-for-your-agent -- uvx serena-agentuvx запускает команду с именем пакета; если в README она другая — uvx --from serena-agent <команда>
Файл настроек
{
"mcpServers": {
"serena-mcp-the-ide-for-your-agent": {
"command": "uvx",
"args": [
"serena-agent"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from serena-agent <команда>
Файл настроек
{
"servers": {
"serena-mcp-the-ide-for-your-agent": {
"type": "stdio",
"command": "uvx",
"args": [
"serena-agent"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from serena-agent <команда>
Командой платформы
gemini mcp add serena-mcp-the-ide-for-your-agent uvx serena-agentuvx запускает команду с именем пакета; если в README она другая — uvx --from serena-agent <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Serena MCP: the IDE for your agent
Как установить Serena MCP в Claude?
Выполните claude mcp add serena -- uvx serena-agent. Команда прописывает сервер в конфигурацию Claude, дальше он стартует сам.
Что делает Serena MCP?
Добавляет агенту инструменты семантического поиска и правки кода: переходы к определениям, поиск ссылок, рефакторинг на уровне символов. Работает поверх language servers по LSP.
Какие языки поддерживает Serena?
Через language servers заявлена поддержка более 40 языков, среди них Python, TypeScript, Go, Rust, Java, C/C++ и другие. Плагин для JetBrains опирается на анализ кода в самой IDE.
