Gopls Go Language Server

MCP-GOPLS

一个封装 gopls、用于提供 Go 语言服务功能的 MCP（Model Context Protocol）服务。

⚠️ WARNING：整个项目由 Claude Code 生成，未经人工代码审查。虽然项目通过了测试且看起来可以正常运行，但请在生产环境中格外谨慎地使用。代码尚未针对安全性、性能或边缘情况进行审计。请参阅 DESIGN.md 了解 AI 生成的设计文档。

功能

现已实现 gopls 的所有语言服务功能：

• GoToDefinition：跳转到符号定义
• FindReferences：查找符号的所有引用
• GetDiagnostics：获取编译错误和静态分析结果
• Hover：获取光标下符号的信息
• SearchSymbol：在工作区中搜索符号（支持部分匹配）
• RenameSymbol：重命名工作区中的符号（直接应用更改到文件）
• FindImplementers：查找实现某个接口的所有类型
• ListDocumentSymbols：获取文件中定义的符号概览
• FormatCode：按照 gofmt 标准格式化 Go 源代码（将更改应用到文件）
• OrganizeImports：整理导入语句（对导入项进行分组和排序，并将更改应用到文件）

安装

go install github.com/yantrio/mcp-gopls/cmd/mcp-gopls@latest

与 Claude 集成

Claude Code

1. 安装 mcp-gopls：

   go install github.com/yantrio/mcp-gopls/cmd/mcp-gopls@latest
   

2. 添加到 Claude Code：

   claude mcp add mcp-gopls "$(which mcp-gopls)"
   

3. 重启 Claude Code：

   claude restart
   

4. 验证安装：

   claude mcp list
   

Claude Desktop

1. 安装 mcp-gopls（与上文相同）

2. 编辑 Claude Desktop 配置：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

3. 将以下内容添加到 mcpServers 部分：

   {
     "mcpServers": {
       "mcp-gopls": {
         "command": "mcp-gopls",
         "args": []
       }
     }
   }
   

   或使用自定义工作区：

   {
     "mcpServers": {
       "mcp-gopls": {
         "command": "mcp-gopls",
         "args": ["-workspace", "/path/to/your/go/project"]
       }
     }
   }
   

4. 重启 Claude Desktop

用法

# Run with default settings (uses gopls in PATH and current directory as workspace)
mcp-gopls

# Specify gopls path and workspace
mcp-gopls -gopls /path/to/gopls -workspace /path/to/project

# Using environment variables
export GOPLS_PATH=/path/to/gopls
export MCP_GOPLS_WORKSPACE=/path/to/project
mcp-gopls

要求

• Go 1.24.3+
• gopls（Go 语言服务）

安装 gopls

go install golang.org/x/tools/gopls@latest

开发

# Clone the repository
git clone https://github.com/yantrio/mcp-gopls
cd mcp-gopls

# Build the project
go build ./cmd/mcp-gopls

# Run tests
go test ./...

许可证

MIT