mcpls 0.3.3

Universal MCP to LSP bridge CLI - expose Language Server Protocol capabilities as MCP tools
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# mcpls

[![Crates.io](https://img.shields.io/crates/v/mcpls)](https://crates.io/crates/mcpls)
[![License](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue)](../../LICENSE-MIT)

**Give your AI agent a compiler's eye.**

The mcpls CLI exposes language server intelligence through MCP. One binary, any language, zero runtime dependencies.

> [!TIP]
> Graceful degradation means you don't need every language server installed. If one fails, mcpls continues with available servers.

## Installation

```bash
cargo install mcpls
```

## Usage

```bash
mcpls                           # Run with defaults
mcpls --log-level debug         # Verbose output
mcpls --config ./mcpls.toml     # Custom config
```

## Configuration

> [!NOTE]
> Configuration auto-discovery order: `$MCPLS_CONFIG` → `./mcpls.toml` → platform config dir
> Auto-creates default config with 30 language mappings on first run.

Create or edit `mcpls.toml` in the appropriate location:
- **Linux/macOS:** `~/.config/mcpls/mcpls.toml`
- **macOS (alternative):** `~/Library/Application Support/mcpls/mcpls.toml`
- **Windows:** `%APPDATA%\mcpls\mcpls.toml`

See the main [README](../../README.md) for configuration examples and custom extension mapping.

## Options

| Flag | Description |
|------|-------------|
| `-c, --config <PATH>` | Configuration file path |
| `-l, --log-level <LEVEL>` | trace, debug, info, warn, error |
| `--log-json` | JSON-formatted logs for tooling |

## Claude Code Integration

Add to your Claude Code configuration (`~/.claude/claude_desktop_config.json`):

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

See the main [README](../../README.md) for full documentation.

## License

Dual-licensed under [Apache 2.0](../../LICENSE-APACHE) or [MIT](../../LICENSE-MIT).