karellen / karellen-lsp-mcp / 22763598618

79%

push

github

Initial implementation of karellen-lsp-mcp

MCP server that bridges to LSP servers, giving LLMs structured code
intelligence (definitions, references, call/type hierarchies, hover,
symbols, diagnostics) — the same information a human developer gets
from their IDE.

Architecture:
- Shared daemon process owns all LSP server subprocesses and a
  refcounted project registry, listening on a Unix domain socket
- Thin MCP stdio frontends (one per Claude session) proxy tool calls
  to the daemon, returning structured dataclass responses
- Multiple sessions sharing the same project get the same LSP server

Features:
- 10 MCP tools: register/deregister projects, query definitions,
  references, hover, document symbols, call hierarchy (in/out),
  type hierarchy (super/sub), diagnostics, indexing status
- Smart readiness handling: single-file queries (definition, hover,
  document symbols) only wait for server initialization, not indexing;
  cross-file queries wait with dynamic timeouts based on progress
- clangd normalizer tracks $/progress for indexing status reporting
- Daemon singleton via filelock, file-based logging, clean apoptosis
  (exits immediately when last frontend disconnects)
- Parent death detection in MCP frontend via getppid() polling
- C/C++ support via clangd with compile_commands.json integration

Includes unit tests, integration tests (with clangd), and CI workflow.

152 of 382 branches covered (39.79%)

Branch coverage included in aggregate %.

756 of 1402 new or added lines in 7 files covered. (53.92%)

756 of 1402 relevant lines covered (53.92%)

2.67 hits per line