# Theodolite

Theodolite — MCP-сервер для Claude Code, который запускает языковые серверы в отдельных сессиях и выставляет навигацию, диагностику и рефакторинг как MCP-инструменты.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: qompassai
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/qompassai/theodolite
- Обновлён: 2026-10-28
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/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.

## Установка

### Claude Code (родная платформа)

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

## Когда брать
- получать информацию о типах и определениях в коде без редактора
- запустить языковый сервер в изолированной сессии для агента
- собрать диагностику и ошибки из нескольких LSP-источников
- применить рефакторинг (переименование, code actions) из бота безопасно
- проверить навигацию и символы проекта программно

## Примеры запросов агенту
- Получи список символов в файле `src/main.rs` через `document_symbols`
- Найди все ссылки на функцию `parse_config` в workspace
- Примени рефакторинг переименования `old_name` → `new_name` и покажи предпросмотр изменений

## Похожие
- [rust-analyzer-lsp](https://affpapa.org/nevibecode/plugins/rust-analyzer-lsp.md) — плагин · ★ 47914 у репозитория
- [lsp-generate](https://affpapa.org/nevibecode/skills/lsp-generate.md) — скилл · ★ 182 у репозитория
- [GodotLens](https://affpapa.org/nevibecode/mcp/godotlens.md) — MCP-сервер · ★ 10 у репозитория
- [golang-gopls](https://affpapa.org/nevibecode/skills/golang-gopls.md) — скилл · 13100 установок
- [rust-symbol-analyzer](https://affpapa.org/nevibecode/skills/rust-symbol-analyzer.md) — скилл · 3500 установок
- [Serena MCP: the IDE for your agent](https://affpapa.org/nevibecode/mcp/serena-mcp-the-ide-for-your-agent.md) — MCP-сервер · ★ 31587 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
