Serena MCP: the IDE for your agent

Serena MCP: the IDE for your agent

oraiosMIT
24.9k звёзд1.7k форков
У людей есть IDE. У AI-агентов такого инструмента не было. Serena меняет ситуацию. Это MCP-сервер, дающий агенту среду разработки с семантикой. Агент оперирует символами — переменными, функциями, классами — и понимает их связи. Результат — меньше ошибок, быстрые правки, контекстное понимание кода. Serena даёт агенту не просто доступ к файлам, а понимание архитектуры. Разница между поиском по слову и знанием, что authUser — это функция из модуля users, возвращающая экземпляр User.
Development
Открыть на GitHub

Установка

uvx serena-agent

Характеристики

Общее

  • СтатусСообщество
  • Разработчикoraios
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Агент находит определения и использования символов с учётом контекста и типов.
  • Агент меняет имя символа во всех файлах одной командой.
  • Агент переносит символы между файлами и автоматически переписывает импорты и зависимости.
  • Агент показывает все точки входа для любого символа.
  • Агент выполняет рефакторинг на уровне абстрактного синтаксического дерева: извлечение метода, встраивание переменной, выделение условного оператора.
  • Агент управляет точками останова, выполняет код по шагам и инспектирует переменные в активном стеке вызовов.
  • Агент распознаёт классы, интерфейсы и их взаимосвязи — наследование, композицию.
  • Инструменты сохраняют производительность на кодобазах с миллионами строк.
  • Единый MCP-интерфейс работает для Python, JavaScript, TypeScript, Go и других языков через LSP и AST.
  • Инструменты спроектированы специально для LLM: один вызов заменяет 8–12 осторожных шагов с grep и ручным редактированием.

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

Шаг 1. Установка

Запустите в терминале uvx serena-agent. Авторы не рекомендуют устанавливать Serena через маркетплейсы — там лежат устаревшие версии.

Шаг 2. Конфигурация

Пропишите сервер в вашем MCP-клиенте. Пример для Claude Desktop:

{ "mcpServers": { "serena": { "command": "uvx", "args": ["serena-agent"] } } }

Файл конфигурации обычно находится в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или в %APPDATA%\Claude\ на Windows.

Шаг 3. Перезапуск

Перезапустите Claude Desktop. В списке инструментов появится Serena.

Примеры запросов

  • «Покажи все места в проекте, где используется функция authenticateUser, и объясни, куда она передаётся дальше.»
  • «Переименуй модель Post в Article. Измени все связанные файлы и импорты.»
  • «Найди реализацию метода validateEmail и покажи её иерархию типов.»
  • «Перенеси хелпер formatDate из utils/time.ts в utils/format.ts. Исправь пути импорта во всех файлах.»

Технические детали

Разработчик: oraios

Язык: Python

Транспорт: stdio (MCP)

Лицензия: MIT

Установка: uvx serena-agent

Клиенты: Claude Desktop, Cursor, VS Code (Cline, Continue), Codex CLI

Поделиться