MCP 语言服务器

一个运行语言服务器并提供与之通信工具的 Model Context Protocol (MCP) 服务器。

动机

Claude 桌面搭配 文件系统 服务器在小型项目上使用时感觉像是魔法。当你添加几个文件和导入后，这种体验就会开始瓦解。通过这个项目，我希望能够为大型项目带来这种体验。

语言服务器在处理 LLM 经常遇到困难的任务方面表现出色，例如精确理解类型、理解关系以及提供准确的符号引用。该项目旨在将这些工具带给 LLM。LSP 似乎也是 MCP 的一个明显灵感来源，因此为什么不把它们结合起来呢？

状态

⚠️ 预 Beta 质量 ⚠️

我已经测试过此服务器与以下语言服务器：

• pyright（Python）
• tsserver（TypeScript）
• gopls（Go）
• rust-analyzer（Rust）

但它应该兼容许多其他语言服务器。

工具

• read_definition：检索任何符号（函数、类型、常量等）的完整源代码定义。
• find_references：定位符号在代码库中的所有使用和引用。
• get_diagnostics：为特定文件提供诊断信息，包括警告和错误。
• get_codelens：检索代码摘要提示以获取更多上下文和代码操作。
• execute_codelens：运行代码摘要操作。
• apply_text_edit：允许对文件进行多项文本编辑。

在幕后，此 MCP 服务器可以处理语言服务器的 workspace/applyEdit 请求，因此它可以执行诸如请求重构、添加导入、格式化代码等操作。

每个工具都支持各种选项以自定义输出，例如包含行号或附加上下文。请参阅工具文档获取详细信息。行号对于 apply_text_edit 能够进行准确编辑是必要的。

关于

此代码库使用了 gopls 处理 LSP 通信的修改后的代码。有关详细信息，请参阅 ATTRIBUTION。

mcp-golang 用于 MCP 通信。

先决条件

安装 Go：请按照 https://golang.org/doc/install 的说明进行操作

获取或更新此服务器：

go install github.com/isaacphi/mcp-language-server@latest

为你的代码库安装一个语言服务器：

• Python（pyright）：npm install -g pyright
• TypeScript（tsserver）：npm install -g typescript typescript-language-server
• Go（gopls）：go install golang.org/x/tools/gopls@latest
• Rust（rust-analyzer）：rustup component add rust-analyzer
• 或使用任何语言服务器

设置

将类似以下配置添加到你的 Claude Desktop 设置（或其他 MCP 支持的客户端）中：

{
  "mcpServers": {
    "language-server": {
      "command": "go",
      "args": [
        "run",
        "github.com/isaacphi/mcp-language-server@latest",
        "--workspace",
        "/Users/you/dev/yourpythoncodebase",
        "--lsp",
        "/opt/homebrew/bin/pyright",
        "--",
        "--stdio"
      ],
      "env": {
        "DEBUG": "1"
      }
    }
  }
}

替换：

• /Users/you/dev/yourpythoncodebase 为你项目的绝对路径
• /opt/homebrew/bin/pyright 为你的语言服务器的路径（使用 which 命令查找，例如 which pyright）
• 任何 -- 符号后的参数都会作为语言服务器的参数传递
• 将 --stdio 替换为其他后端需要的参数

在开发环境中，请参考 配置 进行设置。

聩

包括

env: {
  "DEBUG": 1
}

以获取详细的 LSP 和应用程序日志。请在报告问题时提供尽可能多的信息。

以下功能在我的雷达上：

• [x] 读取定义
• [x] 获取引用
• [x] 应用编辑
• [x] 获取诊断
• [x] 代码摘要
• [ ] 悬停信息
• [ ] 代码操作
• [ ] 更好的上下文和取消处理
• [ ] 添加语言服务器配置选项
• [ ] 创建更一致和可扩展的工具 API（分页等）