MCP LSP Bridge

Brings Language Server Protocol capabilities to MCP-compatible agents like Claude Code. Analyze, navigate, and refactor code across 20+ programming languages.

Status

Under active development - Core functionality works today, but expect rapid improvements and interface changes.

Roadmap

Improve performance for smaller models, Qwen3-4B, quantized models
Improve detection and usage for LSP tools
Add functionality to reduce the number of tools we expose (rename, formatting may be low priority and optional)
Make onboarding easier with default configuration options and separate configuration options that can be scripted (maybe like Lua to allow scripting the LSP configuration)

Quick Start

Install: Download from releases or build with go build

Configure: Add to your MCP client (like Claude Code):

{
  "mcpServers": {
    "lsp": {
      "type": "stdio",
      "command": "mcp-lsp-bridge",
      "args": [],
      "env": {}
    }
  }
}

Configure LSP servers with lsp_config.json in your configuration location: default-directory-locations

or with mcp-lsp-bridge --config /path/to/my-config.json inside your MCP client configuration.

Use: Access LSP tools through your MCP client

See docs/configuration.md for detailed setup.

What It Does

Provides MCP-compatible agents with LSP capabilities:

Code Intelligence: Get documentation, find definitions, trace references, identify errors

Safe Refactoring: Rename symbols, format code, apply quick fixes (with preview mode)

Project Analysis: Search across codebases, understand project structure, detect languages

Supports 20+ languages including Go, Python, TypeScript, Rust, Java, C#, C++.

Configuration

Requires an lsp_config.json file to define language servers. See configuration.md for where to place it.

Basic example with passing your configuration (useful if you want a specific configuration for a project):

mcp-lsp-bridge --config lsp_config.json

In your .mcp.json or other MCP configuration:

{
  "mcpServers": {
    "lsp": {
      "type": "stdio",
      "command": "mcp-lsp-bridge",
      "args": ["--config", "lsp_config.json"],
      "env": {}
    }
  }
}

See docs/configuration.md for complete setup instructions.

Available Tools

16 MCP tools for code analysis and manipulation:

Analysis: Symbol search, project exploration, diagnostics
Navigation: Find definitions, references, implementations
Refactoring: Rename symbols, format code, apply fixes
Intelligence: Hover info, signatures, semantic tokens

📚 Documentation:

Codebase Guide - Architecture and structure overview 🆕
Tools Reference - Complete tool list
Analysis Overview - Quick start guide
Project Analysis Guide - Detailed analysis tool guide
Symbol Exploration Guide - Smart symbol search guide

Docker

Base image available (LSP servers not included):

docker pull ghcr.io/rockerboo/mcp-lsp-bridge:latest

Extend the image to add your needed LSP servers. See docs/configuration.md for examples.

Contribute

Open for contributions. Will help get changes merged in while I develop a contributors document about the key details.

Open issues for any problems you have or ideas for improvement.

mcp-lsp-bridge