mcpls
Bridge MCP to language servers: 31 code-intelligence tools for AI coding agents
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.10.0
- Listing updated
- today
Similar MCP servers
About mcpls
mcpls is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
mcpls runs the language servers for a project, such as rust-analyzer, pyright and gopls, and exposes their output as MCP tools so an agent can answer questions the way an IDE does. Ask for a function's return type and it calls get_hover; ask where an error variant is handled and get_references returns file and line matches.
The README lists type information, cross-references, definitions, implementations, real compiler diagnostics, rename and code-action edits (returned for the client to apply), call and type hierarchies, formatting and inlay hints. In a multi-language project, workspace symbol search spans every server and tags each symbol with its source. Code can be addressed by symbol name as well as position, and several servers start together with graceful degradation if one fails.
It is a single Rust binary with stdio by default and an optional HTTP transport with Host and Origin allowlists. An untrusted-workspace mode exists, but the README warns language servers execute workspace code and mcpls does not sandbox them. Rust projects need no configuration, and you need at least one language server installed.
Install
Run in a terminal
claude mcp add mcpls -- npx -y mcplsAdd to claude_desktop_config.json
{
"mcpServers": {
"mcpls": {
"command": "npx",
"args": [
"-y",
"mcpls"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcpls": {
"command": "npx",
"args": [
"-y",
"mcpls"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcpls": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcpls"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcpls": {
"command": "npx",
"args": [
"-y",
"mcpls"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcpls": {
"command": "npx",
"args": [
"-y",
"mcpls"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- get_hover
- Returns type information and documentation at a position.
- get_references
- Finds references to a symbol.
What it does
- 31 LSP-backed tools
- Exposes language server features as MCP tools.
- Compiler diagnostics
- Returns real diagnostics, not guesses.
- Cross-references
- Finds definitions, references and implementations workspace-wide.
- Refactoring edits
- Returns rename and code-action edits for the client to apply.
- Polyglot symbol search
- Searches across every configured language server.
- Untrusted-workspace mode
- Supports analysing code you do not trust.
Good for
- Ask an agent for a function's type without guessing
- Find every handler of an error variant
- Get compiler diagnostics for a changed file
- Rename a symbol with edits returned for review
Pricing
Open source
Apache-2.0 or MIT
mcpls FAQ
What licence is it?
Dual-licensed Apache 2.0 or MIT.
Does it need language servers installed?
Yes, at least one, such as rust-analyzer.
Is it sandboxed?
No; language servers run workspace code, so read the security notes first.
How do I add it to Claude Code?
Run claude mcp add --scope user mcpls -- mcpls.
Is mcpls free?
Yes. mcpls is open source, so you can use and self-host it for free.
How do I add mcpls to Claude Code?
Run this command in your terminal: claude mcp add mcpls -- npx -y mcpls
What are the best alternatives to mcpls?
The closest alternatives to mcpls are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


