mcpls
by bug-ops·★ 34·Score 46
Universal MCP to LSP bridge that exposes Language Server Protocol capabilities as MCP tools for AI agents.
Overview
mcpls is a universal bridge between AI coding assistants and language servers. It exposes the full power of LSP — type inference, cross-reference analysis, semantic navigation — through the Model Context Protocol, enabling AI agents to reason about code the way IDEs do. This tool provides AI agents with type information, cross-references, semantic navigation, real diagnostics, and safe refactoring capabilities.
Try asking AI
After installing, here are 5 things you can ask your AI assistant:
When to choose this
Choose mcpls when you need AI coding assistants to have deep, structured understanding of your codebase beyond text processing, with access to type systems, cross-references, and real diagnostics.
When NOT to choose this
Don't choose mcpls if you're working primarily with non-LSP supported languages or need write capabilities beyond refactoring, as it focuses on exposing read-only LSP intelligence through MCP.
Tools this server exposes
12 tools extracted from the READMEget_hoverType signatures, documentation, inferred types at any position
get_definitionJump to where a symbol is defined — across files, across crates
get_referencesEvery usage of a symbol in your workspace
get_completionsContext-aware suggestions that respect types and scope
get_document_symbolsStructured outline — functions, types, constants, imports
workspace_symbol_searchFind symbols by name across the entire workspace
get_diagnosticsReal compiler errors and warnings, not guesses
get_code_actionsQuick fixes, refactorings, and source actions at a position
rename_symbolWorkspace-wide rename with full reference tracking
format_documentApply language-specific formatting rules
get_incoming_callsFind all callers of a function (who calls this?)
get_outgoing_callsFind all callees of a function (what does this call?)
Comparable tools
Installation
Installation
cargo install mcplsOr download pre-built binaries from GitHub Releases.
Configure Claude Code
Add to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"mcpls": {
"command": "mcpls",
"args": []
}
}
}Prerequisites
Install at least one language server:
- Rust:
rustup component add rust-analyzer - Python:
npm install -g pyright - TypeScript:
npm install -g typescript-language-server typescript - Go:
go install golang.org/x/tools/gopls@latest
FAQ
- Which language servers are supported?
- mcpls works with any LSP 3.17 compliant server including rust-analyzer, pyright, typescript-language-server, gopls, clangd, jdtls, zls, and 24+ others.
- Does mcpls require configuration?
- No configuration needed for Rust projects with rust-analyzer. For other languages, mcpls uses smart heuristics to spawn only relevant language servers based on project markers.
On Hacker News
Recent discussion from the developer community.
- Story by bug-ops · 2026-01-04
Compare mcpls with
Last updated · Auto-generated from public README + GitHub signals.