mcpls
Universal MCP to LSP bridge - expose Language Server Protocol capabilities as MCP tools for AI agents
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/bug-ops/mcpls with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/bug-ops/mcpls'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/bug-ops--mcpls)HTML
<a href="/listings/bug-ops--mcpls"><img src="/api/listings/bug-ops--mcpls/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
**Linux / 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
Both scripts detect your OS/architecture, download the matching release archive, verify its SHA256 checksum, and install `mcpls` to a per-user directory (`~/.local/bin` on Linux/macOS, `$HOME\.local\bin` on Windows) — no `sudo`/admin rights required.
<details> <summary><strong>Cargo, pre-built binaries & other methods</strong></summary>
**Cargo:**
cargo install mcpls
**Manual download:**
Download the archive matching your platform from [GitHub Releases](https://github.com/bug-ops/mcpls/releases/latest). Each archive has a corresponding `.sha256` checksum file published alongside it — the install scripts above verify this automatically; verify manually if downloading by hand.
| Platform | Architecture | Archive | |----------|--------------|---------| | Linux | x86_64 | `mcpls-x86_64-unknown-linux-gnu.tar.gz` | | Linux | aarch64 | `mcpls-aarch64-unknown-linux-gnu.tar.gz` | | macOS | Intel | `mcpls-x86_64-apple-darwin.tar.gz` | | macOS | Apple Silicon | `mcpls-aarch64-apple-darwin.tar.gz` | | Windows | x86_64 | `mcpls-x86_64-pc-windows-msvc.zip` | | Windows | ARM64 | `mcpls-aarch64-pc-windows-msvc.zip` |
**From source:**
git clone https://github.com/bug-ops/mcpls cd mcpls cargo install --path crates/mcpls-cli
</details>
<details> <summary><strong>Prerequisites (language servers)</strong></summary>
mcpls uses graceful degradation — if one language server fails, it continues with available servers.
**Rust (rust-analyzer):**
rustup component add rust-analyzer # Or: brew install rust-analyzer (macOS)
**Python (pyright, built-in default):**
npm install -g pyright
**Python ([ty](https://docs.astral.sh/ty/), with custom configuration):**
uv tool install ty@latest
**TypeScript:**
npm install -g typescript-language-server typescript@6
`typescript-language-server` needs a JavaScript-based TypeScript (5.x or 6.x): TypeScript 7 ships no `tsserver`. Installing `typescript@6` globally replaces a global TypeScript 7 `tsc`; to keep both, install TypeScript 7 into a separate prefix. mcpls can start the TypeScript 7 native server automatically when it is installed outside the workspace (new generated configs only; an existing config needs `selection = "auto"` added), or you can configure it explicitly (remove `selection` when editing `command` and `args`): see the [configuration guide](docs/user-guide/configuration.md#typescript-7-native-server).
**Go (gopls):**
go install golang.org/x/tools/gopls@latest
> [!IMPORTANT] > At least one language server must be available.
</details>
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 118 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # mcpls
- [](https://crates.io/crates/mcpls)
- [](https://docs.rs/mcpls-core)
- [](https://github.com/bug-ops/mcpls/actions)
- [](https://codecov.io/gh/bug-ops/mcpls)
- [](https://github.com/rust-lang/rust/releases/tag/1.99.0)
- [](LICENSE-MIT)
- **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.
- ```mermaid
- 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](https://bug-ops.github.io/mcpls/getting-started/installation.html) |
- | Connect Claude Code or another client | [Connect an AI Client](https://bug-ops.github.io/mcpls/getting-started/connect-client.html) |
- | Configure language servers | [Configuration](https://bug-ops.github.io/mcpls/guide/configuration.html) |
- | All 31 tools | [Tools Overview](https://bug-ops.github.io/mcpls/tools/overview.html) |
- | Something does not work | [Troubleshooting](https://bug-ops.github.io/mcpls/guide/troubleshooting.html) |
- | HTTP transport and allowlists | [Transports](https://bug-ops.github.io/mcpls/advanced/transports.html) |
- | Security model and untrusted workspaces | [Security and Trust](https://bug-ops.github.io/mcpls/advanced/security.html) |
- | Every flag and config key | [Reference](https://bug-ops.github.io/mcpls/reference/cli.html) |
- ## Installation
- **Linux and macOS:**
- ```bash
- curl -fsSL https://raw.githubusercontent.com/bug-ops/mcpls/main/scripts/install.sh | sh
- ```
- **Windows (PowerShell):**
- ```powershell
- irm https://raw.githubusercontent.com/bug-ops/mcpls/main/scripts/install.ps1 | iex
- ```
- Or with Cargo:
- ```bash
- cargo install mcpls
- ```
- Prebuilt archives for Linux, macOS and Windows (x86_64 and aarch64) with SHA256 checksums and build-provenance attestations are on [GitHub Releases](https://github.com/bug-ops/mcpls/releases/latest).
- mcpls is also listed in the official [MCP Registry](https://registry.modelcontextprotocol.io/?q=mcpls) as `io.github.bug-ops/mcpls` (cargo package, stdio transport), so registry-aware clients can discover it there. The listing installs the same crate as `cargo install mcpls`.
- You also need at least one language server, for example `rustup component add rust-analyzer`. See [Installation](https://bug-ops.github.io/mcpls/getting-started/installation.html) for other methods and servers.
- ## Quick start
- Register mcpls with Claude Code:
- ```bash
- claude mcp add --scope user mcpls -- mcpls
- ```
- Then ask about your code:
- ```text
- 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](https://bug-ops.github.io/mcpls/getting-started/minimal-config.html).
- ## 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
- - **Opt-in context on locations**: the enclosing symbol or its bounded source text (`context: "symbol_source"`) next to each reference, definition or implementation
- - **Call and type hierarchies**, formatting, inlay hints, selection and folding ranges
- - **Workspace symbol search across every language server** of a polyglot project, with each symbol tagged by its server
- - **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 `unsafe` code; release archives carry build-provenance attestations
- ## Security
- Language servers run code that comes with the workspace, and mcpls does not sandbox them. Read [SECURITY.md](SECURITY.md) and the [Security and Trust](https://bug-ops.github.io/mcpls/advanced/security.html) chapter before pointing mcpls at code you did not write.
- ## Agent skill
- [`skills/mcpls`](skills/mcpls/) is a packaged [Agent Skill](https://agentskills.io/specification) that teaches an AI coding agent to install, configure and run mcpls.
- ## Development
- ```bash
- cargo build
- cargo nextest run --workspace --all-features
- ```
- Requires Rust 1.99 or later (edition 2024). The book lives in [`book/`](book/) and is built with [mdBook](https://rust-lang.github.io/mdBook/). See [CONTRIBUTING.md](CONTRIBUTING.md).
- ## Community
- Participation is governed by the [Code of Conduct](CODE_OF_CONDUCT.md). Accessibility of the output and documentation is described in [ACCESSIBILITY.md](ACCESSIBILITY.md).
- ## License
- Dual-licensed under [Apache 2.0](LICENSE-APACHE) or [MIT](LICENSE-MIT) at your option.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.