rockerBOO/mcp-lsp-bridge

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

1. Install: Download from releases or build with go build
2. Configure: Add to your MCP client (like Claude Code):

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

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

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