Repository files navigation

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

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

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

1. Install: Download from releases or build withgo 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 withmcp-lsp-bridge --config /path/to/my-config.json inside your MCP client configuration.

4. Use: Access LSP tools through your MCP client

Seedocs/configuration.md for detailed setup.

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

Requires anlsp_config.json file to define language servers. Seeconfiguration.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": {}    }  }}

Seedocs/configuration.md for complete setup instructions.

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

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. Seedocs/configuration.md for examples.

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.