About Mcpls
Mcpls is an MCP server published by bug-ops in the Developer Tools category: universal MCP to LSP bridge - expose Language Server Protocol capabilities as MCP tools for AI agents.
The repository has 78 stars and 18 forks, with the last commit 3 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/bug-ops/mcplsThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (10)
get_completionsContext-aware suggestions that respect types and scope
Parameters not published.
get_definitionJump to where a symbol is defined — across files, across crates
Parameters not published.
get_document_symbolsStructured outline — functions, types, constants, imports
Parameters not published.
get_hoverType signatures, documentation, inferred types at any position
Parameters not published.
get_inlay_hintsInferred type/parameter annotations an editor would render inline
Parameters not published.
get_referencesEvery usage of a symbol in your workspace
Parameters not published.
get_signature_helpParameter info and active signature while typing a call
Parameters not published.
go_to_implementationJump to implementations of a trait method or interface member
Parameters not published.
go_to_type_definitionJump to the type definition of an expression, distinct from `get_definition` for variable bindings
Parameters not published.
workspace_symbol_searchFind symbols by name across the entire workspace
Parameters not published.
Ask AI
Ask AI about Mcpls
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
mcpls
Give your AI coding agent a compiler's understanding of your code.
mcpls is a bridge between the Model Context Protocol (MCP) and the Language Server Protocol (LSP). It runs the language servers for your project (rust-analyzer, pyright, gopls, and others) and exposes their type information, references, diagnostics and refactoring as 31 MCP tools, so an AI client reasons about code the way an IDE does.
flowchart LR
C["AI client"] <-->|MCP| M["mcpls"] <-->|LSP| S["rust-analyzer / pyright / gopls / ..."]
Documentation
The full documentation is the mcpls book: https://bug-ops.github.io/mcpls/
| Topic | Chapter |
|---|---|
| Install and first run | Installation |
| Connect Claude Code or another client | Connect an AI Client |
| Configure language servers | Configuration |
| All 31 tools | Tools Overview |
| Something does not work | Troubleshooting |
| HTTP transport and allowlists | Transports |
| Security model and untrusted workspaces | Security and Trust |
| Every flag and config key | Reference |
Installation
Linux and macOS:
curl -fsSL https://raw.githubusercontent.com/bug-ops/mcpls/main/scripts/install.sh | sh
Windows (PowerShell):
irm https://raw.githubusercontent.com/bug-ops/mcpls/main/scripts/install.ps1 | iex
Or with Cargo:
cargo install mcpls
You also need at least one language server, for example rustup component add rust-analyzer. See Installation for other methods and servers.
Quick start
Register mcpls with Claude Code:
claude mcp add --scope user mcpls -- mcpls
Then ask about your code:
You: What is the return type of process_request?
Claude: [get_hover] It returns Result<Response, ApiError>.
You: Find everywhere ApiError::Timeout is handled.
Claude: [get_references] Found 4 matches: src/handlers/api.rs:89, ...
Rust projects need no configuration. Other languages and clients are covered in the book.
Features
- Type information and documentation at any position
- Cross-references, definitions, implementations across the whole workspace
- Real diagnostics from the compiler, not guesses
- Rename and code-action edits returned for the client to apply
- Call and type hierarchies, symbol search, formatting, inlay hints, selection and folding ranges
- Address code by symbol name as well as by position, and restart language servers on demand
- Several language servers at once, started concurrently and stopped with mcpls, with graceful degradation when one fails
- stdio by default, optional HTTP transport with Host and Origin allowlists and resource subscriptions
- Untrusted-workspace mode for analyzing code you do not trust
- Single Rust binary, no runtime dependencies, no
unsafecode
Security
Language servers run code that comes with the workspace, and mcpls does not sandbox them. Read SECURITY.md and the Security and Trust chapter before pointing mcpls at code you did not write.
Agent skill
skills/mcpls is a packaged Agent Skill that teaches an AI coding agent to install, configure and run mcpls.
Development
cargo build
cargo nextest run --workspace --all-features
Requires Rust 1.99 or later (edition 2024). The book lives in book/ and is built with mdBook. See CONTRIBUTING.md.
Community
Participation is governed by the Code of Conduct. Accessibility of the output and documentation is described in ACCESSIBILITY.md.
License
Dual-licensed under Apache 2.0 or MIT at your option.
README fetched from the repository 7 hours ago. The original is authoritative.