lsp-to-mcp protocol bridging with multi-language server support
Exposes Language Server Protocol (LSP) capabilities through the Model Context Protocol (MCP) interface, enabling Claude and other MCP clients to invoke LSP features (code completion, diagnostics, hover information, symbol navigation) by translating MCP tool calls into LSP JSON-RPC messages and routing responses back through the MCP transport layer. Implements bidirectional message marshaling between the two protocol stacks with automatic capability discovery from connected LSP servers.
Unique: Implements a bidirectional protocol adapter that maps the full LSP specification onto MCP's tool-calling interface, allowing any LSP server to become an MCP resource without modifying the LSP server itself. Uses stdio-based process management to spawn and communicate with LSP servers, with automatic capability negotiation via LSP's initialize handshake.
vs alternatives: Unlike language-specific MCP servers (e.g., separate TypeScript, Python, Rust MCP implementations), cclsp provides a single unified bridge that works with any LSP-compatible server, reducing maintenance burden and enabling support for new languages immediately when LSP servers are available.
code completion and intellisense via lsp textdocument/completion
Translates MCP tool calls into LSP textDocument/completion requests, querying the connected language server for context-aware code suggestions at a specific file position. Returns completion items with type information, documentation, and insertion text, leveraging the LSP server's semantic understanding of the codebase rather than pattern matching or static analysis.
Unique: Directly exposes LSP's textDocument/completion protocol without abstraction, preserving all metadata (completion kind, documentation, additionalTextEdits) that the LSP server provides. Handles completion context negotiation (trigger characters, incomplete flags) transparently.
vs alternatives: Provides semantic completions from the actual language server (with full type awareness) rather than regex-based or token-frequency approaches, resulting in more accurate suggestions for complex codebases with multiple imports and namespaces.
document and workspace synchronization with lsp didopen, didchange, didclose notifications
Manages LSP document lifecycle notifications (didOpen, didChange, didClose, didSave) to keep the LSP server's view of the codebase synchronized with the MCP client's state. Translates file changes from the MCP client into LSP notifications, ensuring the LSP server has current file content for accurate analysis. Implements incremental change tracking to minimize bandwidth and server load.
Unique: Implements LSP's document synchronization protocol with support for both full and incremental document updates. Maintains document version tracking to ensure the LSP server processes changes in order.
vs alternatives: Enables real-time LSP analysis on in-memory file changes without requiring disk I/O, compared to approaches that require saving files to disk before analysis.
multi-language server orchestration and capability negotiation
Manages connections to multiple LSP servers simultaneously, each serving different languages or file types. Implements LSP initialize/shutdown handshake for each server, negotiates supported capabilities, and routes file operations to the appropriate language server based on file extension or language ID. Enables a single MCP instance to provide code intelligence for polyglot codebases.
Unique: Manages multiple LSP server instances with independent lifecycle management and capability negotiation. Routes requests to the appropriate server based on file language ID, enabling seamless multi-language support.
vs alternatives: Provides language-specific code intelligence for each language (using the actual language server) rather than attempting to provide generic code intelligence across all languages, resulting in more accurate and feature-rich analysis.
diagnostic collection and code quality analysis via lsp textdocument/publishdiagnostics
Subscribes to LSP textDocument/publishDiagnostics notifications and exposes collected diagnostics (errors, warnings, hints) as queryable MCP resources. Maintains a diagnostic cache indexed by file URI, allowing Claude to retrieve current code quality issues, their severity levels, and suggested fixes without re-running analysis.
Unique: Passively collects LSP publishDiagnostics notifications and exposes them as queryable state rather than requiring active polling. Maintains diagnostic history indexed by file, enabling Claude to track which issues have been resolved or introduced.
vs alternatives: Provides real-time diagnostics from the language server's actual compilation/analysis pipeline rather than running separate linters, ensuring diagnostics match the language server's understanding of the codebase (important for type-aware languages like TypeScript).
symbol definition and reference navigation via lsp textdocument/definition and textdocument/references
Implements LSP textDocument/definition and textDocument/references requests to enable code navigation and symbol resolution. Translates MCP queries into LSP position-based requests, returning file locations and ranges where a symbol is defined or referenced, enabling Claude to understand code structure and trace dependencies.
Unique: Delegates symbol resolution to the LSP server's semantic index rather than implementing custom parsing or regex-based matching. Supports both definition and references queries through a unified position-based interface, enabling bidirectional code navigation.
vs alternatives: Provides accurate symbol resolution for statically-typed languages (TypeScript, Go, Rust) where the LSP server has full type information, compared to regex-based approaches that struggle with overloaded functions, shadowed variables, and complex scoping rules.
hover information and type inspection via lsp textdocument/hover
Exposes LSP textDocument/hover requests through MCP, returning type signatures, documentation, and contextual information about a symbol at a specific position. Enables Claude to inspect types, read documentation, and understand symbol semantics without opening the symbol's definition file.
Unique: Directly exposes LSP's hover capability without interpretation, preserving markdown formatting and rich documentation that the LSP server provides. Enables Claude to access type information without navigating to definition files.
vs alternatives: Provides accurate type information from the language server's semantic analysis (with full type inference) rather than static parsing, enabling Claude to understand complex types like generics, union types, and conditional types in TypeScript.
workspace symbol search via lsp workspace/symbol
Implements LSP workspace/symbol requests to enable global symbol search across the entire workspace. Translates MCP search queries into LSP symbol queries, returning matching symbols with their locations, kinds (function, class, variable, etc.), and file paths. Enables Claude to discover available APIs and understand codebase structure without file-by-file navigation.
Unique: Delegates workspace-wide symbol indexing to the LSP server rather than implementing custom indexing. Supports fuzzy matching and filtering by symbol kind, enabling flexible discovery of available APIs.
vs alternatives: Provides accurate symbol search across the entire workspace (including external dependencies and generated code) compared to grep-based approaches that may miss symbols in non-text files or have difficulty with language-specific syntax.
+4 more capabilities