# Theodolite

Theodolite is an MCP server for Claude Code that spawns language-server sessions in isolation and exposes navigation, diagnostics, and refactoring as MCP tools.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: qompassai
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qompassai/theodolite
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/theodolite

## What it does

Theodolite maintains its own pinned language-server sessions—Rust Analyzer, Lua Language Server, bacon-ls, serve-d for D—and surfaces their functions as a closed set of MCP tools. The read surface includes `hover`, `definition`, `references`, `document_symbols`, `diagnostics`, and `code_actions` (listings only, no execution). This contrasts with periscope, which reads through a human's live editor.

The bridge is deterministic: child processes are spawned by absolute path through `setpriv`, server versions are pinned exactly, and config is validated before startup. Communication happens over stdio with NDJSON JSON-RPC. The configuration is TOML; you pin binary paths and capture exact `--version` output from your target machine.

Mutation tools (`code_action_apply`, `rename_apply`) are gated off by default. Enable them via `mutation = "gated"` with a non-empty `mutation_allowlist`. Handles for code actions are minted server-side; the bridge writes file contents only (no creation or deletion), validates every edit before applying, and uses atomic temp-and-rename operations.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- retrieve type information and definitions from code outside an editor
- spawn an isolated language-server session for an AI agent
- aggregate diagnostics from multiple LSP sources
- apply refactoring and code actions from a bot safely
- query navigation and workspace symbols programmatically

## Example prompts
- List all symbols in `src/main.rs` using `document_symbols`
- Find every reference to the function `parse_config` across the workspace
- Preview a rename of `old_name` to `new_name` and show the full change set

## Similar
- [rust-analyzer-lsp](https://affpapa.org/en/nevibecode/plugins/rust-analyzer-lsp.md) — plugin · ★ 47914 repo stars
- [lsp-generate](https://affpapa.org/en/nevibecode/skills/lsp-generate.md) — skill · ★ 182 repo stars
- [GodotLens](https://affpapa.org/en/nevibecode/mcp/godotlens.md) — MCP server · ★ 10 repo stars
- [golang-gopls](https://affpapa.org/en/nevibecode/skills/golang-gopls.md) — skill · 13100 installs
- [rust-symbol-analyzer](https://affpapa.org/en/nevibecode/skills/rust-symbol-analyzer.md) — skill · 3500 installs
- [Serena MCP: the IDE for your agent](https://affpapa.org/en/nevibecode/mcp/serena-mcp-the-ide-for-your-agent.md) — MCP server · ★ 31587 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
