An MCP (Model Context Protocol) server that wraps gopls to provide Go language server features.
⚠️ WARNING: This entire project was generated by Claude Code without human code review. While it passes tests and appears functional, please use with EXTREME CAUTION in production environments. The code has not been audited for security, performance, or edge cases. See DESIGN.md for the AI-generated design document.
All gopls language server features are now implemented:
- GoToDefinition: Navigate to the definition of a symbol
- FindReferences: Find all references to a symbol
- GetDiagnostics: Get compile errors and static analysis findings
- Hover: Get information about symbols under the cursor
- SearchSymbol: Search for symbols across the workspace (supports partial matching)
- RenameSymbol: Rename symbols across the workspace (applies changes directly to files)
- FindImplementers: Find all types that implement an interface
- ListDocumentSymbols: Get an outline of symbols defined in a file
- FormatCode: Format Go source code according to gofmt standards (applies changes to files)
- OrganizeImports: Organize import statements (groups and sorts imports, applies changes to files)
go install github.com/yantrio/mcp-gopls/cmd/mcp-gopls@latest-
Install mcp-gopls:
go install github.com/yantrio/mcp-gopls/cmd/mcp-gopls@latest
-
Add to Claude Code:
claude mcp add mcp-gopls "$(which mcp-gopls)" -
Restart Claude Code:
claude restart
-
Verify installation:
claude mcp list
-
Install mcp-gopls (same as above)
-
Edit Claude Desktop configuration:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
Add the following to the
mcpServerssection:{ "mcpServers": { "mcp-gopls": { "command": "mcp-gopls", "args": [] } } }Or with custom workspace:
{ "mcpServers": { "mcp-gopls": { "command": "mcp-gopls", "args": ["-workspace", "/path/to/your/go/project"] } } } -
Restart 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 language server)
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