# mcpls

> mcpls is an open-source MCP server for developer tools. Bridge MCP to language servers: 31 code-intelligence tools for AI coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/bug-ops/mcpls
- **MCP Registry name:** io.github.bug-ops/mcpls
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcpls -- npx -y mcpls
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcpls": {
      "command": "npx",
      "args": [
        "-y",
        "mcpls"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcpls": {
      "command": "npx",
      "args": [
        "-y",
        "mcpls"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcpls": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcpls"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcpls": {
      "command": "npx",
      "args": [
        "-y",
        "mcpls"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcpls": {
      "command": "npx",
      "args": [
        "-y",
        "mcpls"
      ]
    }
  }
}
```

## Tools

- `get_hover`: Returns type information and documentation at a position.
- `get_references`: Finds references to a symbol.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/mcpls
