Symbols MCP

Чтение, проверка и навигация по символам кодовой базы путем подключения к языковым серверам.

Введение

Подключаясь к выбранному языковому серверу, этот MCP-сервер позволяет агентам кодирования легко и эффективно исследовать кодовую базу и ее зависимости. Сервер предлагает минимальный набор инструментов, ресурсов и навыков, предназначенных для простого использования и экономного расходования контекста модели.

Инструменты

• outline: возвращает структуру символов кода в файле, опционально с небольшим фрагментом кода

• inspect: возвращает документацию, а также места объявления и реализации символа, включая сторонние

• search: выполняет поиск соответствующих символов по всей кодовой базе

• references: находит все ссылки на символ по всей кодовой базе

• call_hierarchy: возвращает входящие и исходящие связи вызовов для вызываемого символа

• rename: переименовывает все ссылки на символ по всей кодовой базе

• diagnostics: возвращает активную диагностику в указанном файле

• completion: возвращает контекстные подсказки в заданном месте

• reload: перезагружает эффективную конфигурацию и применяет ее к запущенным в данный момент языковым серверам

Ресурсы

• language-servers://profiles: возвращает настроенные языковые серверы вместе с их состоянием.

• language-servers://profiles/{name}: возвращает более подробный обзор одного языкового сервера.

• language-servers://profiles/{name}/logs: возвращает логи языкового сервера для устранения неполадок.

Навыки

• install-language-server: устанавливает, настраивает, проверяет или устраняет неполадки профиля языкового сервера для текущей рабочей области.

• language-server-navigation: направляет проверку символов, ссылки, переименование, диагностику и поиск через инструменты языкового сервера перед переходом к текстовому поиску.

Related MCP server: Serena

Установка

Установка агента

Установите MCP-сервер, навыки агента через плагины и расширения, а затем попросите агента установить любой соответствующий языковой сервер для кодовой базы.

• Добавить расширение: gemini extensions install p1va/symbols

• Спросить Gemini: Please install the language servers relevant to this codebase

• Добавить MCP-сервер: codex mcp add language-servers -- npx -y @p1va/symbols@latest start

• Добавить навыки языкового сервера: npx skills add p1va/symbols -a codex

• Спросить Codex: Please install the language servers relevant to this codebase

Ручная установка

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

Разработка

• pnpm lint выводит нарушения линтинга

• pnpm lint:fix пытается исправить нарушения линтинга

• pnpm format форматирует кодовую базу

• pnpm dev запускает в режиме разработки

• pnpm build запускает линтер и сборку

• pnpm start запускает собранные артефакты

• pnpm test:unit запускает модульные тесты

• pnpm test:integration:{language id} запускает интеграционные тесты для заданного языка

Релиз

• pnpm sync:skills для зеркалирования .agents/skills/ в:

  • skills/ для расширения Gemini

  • plugins/symbols/skills/ для плагина Codex.

• pnpm version patch для увеличения версии и создания тега. Затем:

  • pnpm sync:version для обновления манифестов плагина и расширения.

  • git push --follow-tags для отправки коммита и тега.