🚀 MCP 语言服务器
MCP 语言服务器是一个运行语言服务器并提供与之通信工具的 Model Context Protocol (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 - 或使用任何语言服务器
- Python（pyright）：
设置
将类似以下配置添加到你的 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替换为其他后端需要的参数。
在开发环境中，请参考 配置 进行设置。
✨ 主要特性
带来大型项目高效体验
Claude 桌面搭配 文件系统 服务器在小型项目上使用体验出色，但在大型项目上有所不足。此项目旨在为大型项目带来类似小型项目的高效体验。
结合语言服务器优势
语言服务器在处理 LLM 经常遇到困难的任务方面表现出色，例如精确理解类型、理解关系以及提供准确的符号引用。该项目将这些工具带给 LLM，且 LSP 是 MCP 的明显灵感来源，实现了两者的结合。
丰富的工具支持
read_definition：检索任何符号（函数、类型、常量等）的完整源代码定义。find_references：定位符号在代码库中的所有使用和引用。get_diagnostics：为特定文件提供诊断信息，包括警告和错误。get_codelens：检索代码摘要提示以获取更多上下文和代码操作。execute_codelens：运行代码摘要操作。apply_text_edit：允许对文件进行多项文本编辑。
在幕后，此 MCP 服务器可以处理语言服务器的 workspace/applyEdit 请求，因此它可以执行诸如请求重构、添加导入、格式化代码等操作。每个工具都支持各种选项以自定义输出，例如包含行号或附加上下文。行号对于 apply_text_edit 能够进行准确编辑是必要的。
📦 安装指南
安装 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 - 或使用任何语言服务器
📚 详细文档
状态说明
⚠️ 预 Beta 质量 ⚠️
我已经测试过此服务器与以下语言服务器：
- pyright（Python）
- tsserver（TypeScript）
- gopls（Go）
- rust-analyzer（Rust）
但它应该兼容许多其他语言服务器。
关于代码库
此代码库使用了 gopls 处理 LSP 通信的修改后的代码。有关详细信息，请参阅 ATTRIBUTION。
mcp-golang 用于 MCP 通信。
调试与日志
包括
env: {
"DEBUG": 1
}
以获取详细的 LSP 和应用程序日志。请在报告问题时提供尽可能多的信息。
待实现功能
以下功能在我的雷达上：
- [x] 读取定义
- [x] 获取引用
- [x] 应用编辑
- [x] 获取诊断
- [x] 代码摘要
- [ ] 悬停信息
- [ ] 代码操作
- [ ] 更好的上下文和取消处理
- [ ] 添加语言服务器配置选项
- [ ] 创建更一致和可扩展的工具 API（分页等）
注意事项
⚠️ 重要提示
目前项目处于预 Beta 质量阶段，使用时可能存在不稳定情况。
💡 使用建议
在报告问题时，请包含详细的 LSP 和应用程序日志（通过设置
env: { "DEBUG": 1 }获取），以提供尽可能多的信息。