mcpls

Crates.iomcpls
lib.rsmcpls
version0.3.1
created_at2025-12-25 00:42:32.293968+00
updated_at2026-01-24 01:08:21.451419+00
descriptionUniversal MCP to LSP bridge CLI - expose Language Server Protocol capabilities as MCP tools
homepage
repositoryhttps://github.com/bug-ops/mcpls
max_upload_size
id2004053
size63,172
Andrei G (bug-ops)

documentation

README

mcpls

Crates.io License

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

cargo install mcpls

Usage

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 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):

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

See the main README for full documentation.

License

Dual-licensed under Apache 2.0 or MIT.

Commit count: 39

cargo fmt