MCP-LSP Bridge

MCP LSP Bridge

为 Claude Code 等兼容 MCP 的 Agent 提供 Language Server Protocol 能力。支持在 20 多种编程语言中分析、导航和重构代码。

状态

正在积极开发——核心功能目前已可用，但请预期会快速改进并发生接口变更。

路线图

• 提升对较小模型、Qwen3-4B 和量化模型的性能
• 改进对 LSP 工具的检测和使用
• 添加减少公开工具数量的功能（重命名、格式化的优先级可能较低，也可以设为可选）
• 通过默认配置选项和可脚本化的独立配置选项简化入门（或许可以使用 Lua，以便脚本化配置 LSP）

快速开始

1. 安装：从 releases 下载，或使用 go build 构建
2. 配置：将其添加到 MCP 客户端（例如 Claude Code）：

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

3. 使用配置位置中的 lsp_config.json 配置 LSP 服务：默认目录位置

• 或在 MCP 客户端配置中使用 mcp-lsp-bridge --config /path/to/my-config.json。

4. 使用：通过 MCP 客户端使用 LSP 工具

详细设置说明请参阅 docs/configuration.md。

功能

为兼容 MCP 的 Agent 提供 LSP 能力：

代码智能：获取文档、查找定义、追踪引用、识别错误

安全重构：重命名符号、格式化代码、应用快速修复（支持预览模式）

项目分析：跨代码库搜索、了解项目结构、检测语言

支持 20 多种语言，包括 Go、Python、TypeScript、Rust、Java、C#、C++。

配置

需要使用 lsp_config.json 文件定义语言服务。有关文件放置位置，请参阅 configuration.md。

传入配置的基本示例（适用于需要为特定项目使用特定配置的情况）：

mcp-lsp-bridge --config lsp_config.json

在 .mcp.json 或其他 MCP 配置中：

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

完整设置说明请参阅 docs/configuration.md。

可用工具

提供 16 个用于代码分析和操作的 MCP 工具：

• 分析：符号搜索、项目探索、诊断
• 导航：查找定义、引用和实现
• 重构：重命名符号、格式化代码、应用修复
• 智能功能：悬停信息、签名、语义令牌

📚 文档：

• 代码库指南 - 架构和结构概览 🆕
• 工具参考 - 完整工具列表
• 分析概览 - 快速入门指南
• 项目分析指南 - 详细的分析工具指南
• 符号探索指南 - 智能符号搜索指南

Docker

提供基础镜像（不包含 LSP 服务）：

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

扩展镜像以添加所需的 LSP 服务。示例请参阅 docs/configuration.md。

贡献

欢迎贡献。在我编写介绍关键细节的贡献者文档期间，我会协助合并更改。

如有任何问题或改进想法，请提交 issue。