mcp-gopls

Overview

mcp-gopls is an MCP server that bridges AI assistants with Go's powerful language server (gopls). It provides a comprehensive set of LSP features including code navigation, diagnostics, formatting, test execution, coverage analysis, and Go module management. The server offers more functionality than gopls' built-in MCP implementation, particularly for development operations like running tests, tidying modules, and analyzing coverage.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• go_to_definition

  Navigate to the definition of a symbol

  Try:Find the definition of function FooTry:Where is the Bar struct defined?
• find_references

  List all references for a symbol

  Try:Find all references to variable myVarTry:Show me where function baz is used
• check_diagnostics

  Fetch cached diagnostics for a file

  Try:Check diagnostics for main.goTry:Show errors in utils.go
• get_hover_info

  Return hover markdown for a symbol

  Try:Show hover info for function myFunctionTry:What does interface Foo contain?
• get_completion

  Return completion labels at a position

  Try:Show completions at the end of this lineTry:What can I import here?
• format_document

  Return formatting edits for an entire document

  Try:Format this documentTry:Make this code gofmt compliant
• rename_symbol

  Return workspace edits for a rename

  Try:Rename variable oldName to newNameTry:Change class name from A to B
• list_code_actions

  List available code actions for a range

  Try:Show available code actions for this functionTry:What refactors are possible here?
• search_workspace_symbols

  Search workspace-wide symbols

  Try:Search for all functions named ProcessTry:Find all structs with Handler in the name
• analyze_coverage

  Run go test with coverage + optional per-function report

  Try:Run coverage for ./pkg/serverTry:Test ./pkg/tools with per-function coverage
• run_go_test

  Execute go test for a package/pattern

  Try:Run tests for ./pkg/serverTry:Test all integration tests
• run_govulncheck

  Execute govulncheck on the codebase

  Try:Run govulncheck on the entire projectTry:Check vulnerabilities in ./pkg/...

Comparable tools

Installation

# Install the server
go install github.com/hloiseau/mcp-gopls/v2/cmd/mcp-gopls@latest

# Configure Claude Desktop
{
  "mcpServers": {
    "mcp-gopls": {
      "command": "mcp-gopls",
      "args": ["--workspace", "/absolute/path/to/your/go/project"],
      "env": {
        "MCP_GOPLS_LOG_LEVEL": "info"
      }
    }
  }
}

FAQ

How does mcp-gopls compare to gopls built-in MCP?

mcp-gopls provides more development-focused tools like go test, coverage analysis, and go mod tidy, while gopls built-in MCP focuses more on introspective tools like diagnostics and symbol search.

What Go versions are supported?

Tested with Go 1.25.x and gopls@latest. The project actively maintains compatibility with recent Go versions.

Compare mcp-gopls with