Skip to content
MCP server

mcpls

Bridge MCP to language servers: 31 code-intelligence tools for AI coding agents

Runs locallyStatus and history
Install
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 mcpls

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcpls": {
      "command": "npx",
      "args": [
        "-y",
        "mcpls"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcpls": {
      "command": "npx",
      "args": [
        "-y",
        "mcpls"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers