symbols — MCP-сервер для Claude Code: навигация по символам кода
Подключается к Language Server и даёт агенту читать символы, ссылки и диагностику в проекте. Пригодится, когда поиск по тексту уже не справляется.
claude mcp add symbols -- npx -y @p1va/symbolsЧто делает symbols
symbols — это MCP-сервер, который связывает кодинг-агента с Language Server выбранного языка. Агент получает структуру файла, расположение объявления и реализации символа, все ссылки на него, входящие и исходящие вызовы. Работает и со сторонними зависимостями, а не только с вашим кодом.
Внутри набор инструментов: outline, inspect, search, references, call_hierarchy, rename, diagnostics, completion и reload. Есть ресурсы вида language-servers://profiles со списком настроенных серверов и их состоянием, а логи отдельного сервера лежат в language-servers://profiles/{name}/logs. Два скилла — install-language-server и language-server-navigation — помогают настроить профиль под текущий workspace и подсказывают порядок работы.
Сервер запускается через npx, так что нужен установленный Node.js с доступом в npm. Без настроенного Language Server для вашего языка инструменты работать не будут: сначала ставьте профиль, потом ждите навигацию по символам. Переименование через rename меняет все ссылки сразу — на большом репозитории это стоит делать на чистой ветке.
Какие задачи решает
- найти все места, где вызывается функция, до её переименования
- получить структуру файла вместо чтения его целиком
- разобраться, откуда берётся ошибка компилятора в конкретном файле
- посмотреть объявление и реализацию метода из сторонней библиотеки
- проследить цепочку вызовов перед рефакторингом
Примеры запросов агенту
- Покажи структуру файла
src/server.tsчерез symbols - Найди все ссылки на
parseConfigв проекте - Переименуй
oldHandlerвhandleRequestпо всему коду
Как установить symbols
Командой платформы
claude mcp add symbols -- npx -y @p1va/symbolsКомандой платформы
codex mcp add symbols -- npx -y @p1va/symbolsФайл настроек
{
"mcpServers": {
"symbols": {
"command": "npx",
"args": [
"-y",
"@p1va/symbols"
]
}
}
}Файл настроек
{
"servers": {
"symbols": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@p1va/symbols"
]
}
}
}Командой платформы
gemini mcp add symbols npx -y @p1va/symbolsПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о symbols
Как установить symbols в Claude Code?
Одной командой: claude mcp add symbols -- npx -y @p1va/symbols. После этого попросите агента настроить Language Server под ваш проект.
Что делает symbols?
Даёт агенту доступ к символам кода через Language Server: структура файла, ссылки, вызовы, диагностика и переименование. Это точнее, чем поиск по тексту.
Что нужно, чтобы symbols заработал?
Node.js для запуска через npx и настроенный профиль Language Server для языка вашего проекта. Скилл install-language-server помогает его поставить и проверить.
