Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bug-ops--mcpls/badge.svg)](/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

i

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.

  1. # mcpls
  2. [![Crates.io](https://img.shields.io/crates/v/mcpls?label=mcpls)](https://crates.io/crates/mcpls)
  3. [![docs.rs](https://img.shields.io/docsrs/mcpls-core?label=mcpls-core)](https://docs.rs/mcpls-core)
  4. [![CI](https://img.shields.io/github/actions/workflow/status/bug-ops/mcpls/ci.yml?branch=main)](https://github.com/bug-ops/mcpls/actions)
  5. [![codecov](https://codecov.io/gh/bug-ops/mcpls/graph/badge.svg?token=FQEDLNF2GS)](https://codecov.io/gh/bug-ops/mcpls)
  6. [![MSRV](https://img.shields.io/badge/MSRV-1.99-blue)](https://github.com/rust-lang/rust/releases/tag/1.99.0)
  7. [![License](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue)](LICENSE-MIT)
  8. **Give your AI coding agent a compiler's understanding of your code.**
  9. 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.
  10. ```mermaid
  11. flowchart LR
  12. C["AI client"] <-->|MCP| M["mcpls"] <-->|LSP| S["rust-analyzer / pyright / gopls / ..."]
  13. ```
  14. ## Documentation
  15. The full documentation is the mcpls book: **<https://bug-ops.github.io/mcpls/>**
  16. | Topic | Chapter |
  17. |-------|---------|
  18. | Install and first run | [Installation](https://bug-ops.github.io/mcpls/getting-started/installation.html) |
  19. | Connect Claude Code or another client | [Connect an AI Client](https://bug-ops.github.io/mcpls/getting-started/connect-client.html) |
  20. | Configure language servers | [Configuration](https://bug-ops.github.io/mcpls/guide/configuration.html) |
  21. | All 31 tools | [Tools Overview](https://bug-ops.github.io/mcpls/tools/overview.html) |
  22. | Something does not work | [Troubleshooting](https://bug-ops.github.io/mcpls/guide/troubleshooting.html) |
  23. | HTTP transport and allowlists | [Transports](https://bug-ops.github.io/mcpls/advanced/transports.html) |
  24. | Security model and untrusted workspaces | [Security and Trust](https://bug-ops.github.io/mcpls/advanced/security.html) |
  25. | Every flag and config key | [Reference](https://bug-ops.github.io/mcpls/reference/cli.html) |
  26. ## Installation
  27. **Linux and macOS:**
  28. ```bash
  29. curl -fsSL https://raw.githubusercontent.com/bug-ops/mcpls/main/scripts/install.sh | sh
  30. ```
  31. **Windows (PowerShell):**
  32. ```powershell
  33. irm https://raw.githubusercontent.com/bug-ops/mcpls/main/scripts/install.ps1 | iex
  34. ```
  35. Or with Cargo:
  36. ```bash
  37. cargo install mcpls
  38. ```
  39. 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).
  40. 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`.
  41. 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.
  42. ## Quick start
  43. Register mcpls with Claude Code:
  44. ```bash
  45. claude mcp add --scope user mcpls -- mcpls
  46. ```
  47. Then ask about your code:
  48. ```text
  49. You: What is the return type of process_request?
  50. Claude: [get_hover] It returns Result<Response, ApiError>.
  51. You: Find everywhere ApiError::Timeout is handled.
  52. Claude: [get_references] Found 4 matches: src/handlers/api.rs:89, ...
  53. ```
  54. 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).
  55. ## Features
  56. - **Type information and documentation** at any position
  57. - **Cross-references, definitions, implementations** across the whole workspace
  58. - **Real diagnostics** from the compiler, not guesses
  59. - **Rename and code-action edits** returned for the client to apply
  60. - **Opt-in context on locations**: the enclosing symbol or its bounded source text (`context: "symbol_source"`) next to each reference, definition or implementation
  61. - **Call and type hierarchies**, formatting, inlay hints, selection and folding ranges
  62. - **Workspace symbol search across every language server** of a polyglot project, with each symbol tagged by its server
  63. - **Address code by symbol name** as well as by position, and restart language servers on demand
  64. - **Several language servers at once**, started concurrently and stopped with mcpls, with graceful degradation when one fails
  65. - **stdio by default**, optional HTTP transport with Host and Origin allowlists and resource subscriptions
  66. - **Untrusted-workspace mode** for analyzing code you do not trust
  67. - **Single Rust binary**, no runtime dependencies, no `unsafe` code; release archives carry build-provenance attestations
  68. ## Security
  69. 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.
  70. ## Agent skill
  71. [`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.
  72. ## Development
  73. ```bash
  74. cargo build
  75. cargo nextest run --workspace --all-features
  76. ```
  77. 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).
  78. ## Community
  79. 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).
  80. ## License
  81. 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 in

Free to use. If it’s helped, pass it on.