Theodolite — MCP-сервер для Claude Code: LSP-мост без редактора
Theodolite — MCP-сервер для Claude Code, который запускает языковые серверы в отдельных сессиях и выставляет навигацию, диагностику и рефакторинг как MCP-инструменты.
Apache-2.0 обновлён 2026-10-28
Открыть на GitHubЧто делает Theodolite
Theodolite держит собственные pinned сессии языковых серверов — Rust Analyzer, Lua Language Server, bacon-ls, serve-d для D — и предоставляет их функции как замкнутый набор MCP-инструментов. Инструменты работают в режиме чтения: hover, definition, references, document_symbols, diagnostics, code_actions (список только, без выполнения). Это отличает его от periscope, который смотрит сквозь живой редактор человека.
Мост детерминирован: сессии spawned через setpriv в очищенном окружении, версии серверов пинятся точно. Конфиг — TOML с путями до бинарей и версий; мост отказывается запускаться, если конфиг невалиден. LSP общается через stdio, NDJSON JSON-RPC.
Мутирующие инструменты (code_action_apply, rename_apply) гейтированы: по умолчанию выключены. Включаются через mutation = "gated" в конфиге с allowlist клиентов. Handles для code-action минтятся на стороне моста, редактирует bridge только содержимое файлов (не создаёт, не удаляет), валидирует перед записью и синхронизирует через атомарные операции temp + rename.
Какие задачи решает
- получать информацию о типах и определениях в коде без редактора
- запустить языковый сервер в изолированной сессии для агента
- собрать диагностику и ошибки из нескольких LSP-источников
- применить рефакторинг (переименование, code actions) из бота безопасно
- проверить навигацию и символы проекта программно
Примеры запросов агенту
- Получи список символов в файле
src/main.rsчерезdocument_symbols - Найди все ссылки на функцию
parse_configв workspace - Примени рефакторинг переименования
old_name→new_nameи покажи предпросмотр изменений
Как установить Theodolite
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Theodolite
Как установить Theodolite в Claude Code?
Theodolite запускается отдельно как MCP-сервер: соберите исходник с cargo build --release, затем запустите ./target/release/theodolite --config bridge.toml. Конфиг описывает языковые серверы (Rust Analyzer, Lua Language Server и другие) и их версии. Подключите его в Claude Code как MCP через стандартный механизм конфигурации моделей.
Что делает Theodolite?
Это LSP-мост: держит собственные сессии языковых серверов и выставляет их возможности (поиск определений, диагностика, рефакторинг, символы) как инструменты MCP. Работает без редактора — для ботов, агентов, sandbox'ей и worker'ов.
Можно ли применять рефакторинг через Theodolite?
Да, но это гейтировано. По умолчанию инструменты только читают код. Включите mutation = "gated" в конфиге и укажите allowlist клиентов в mutation_allowlist — тогда code_action_apply и rename_apply станут доступны только для доверенных клиентов. Мост валидирует каждое изменение и применяет его атомарно.