Go language server (gopls) wrapped as an MCP server

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)

1. Install mcp-gopls:

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

2. Add to Claude Code:

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

3. Restart Claude Code:

4. Verify installation:

1. Install mcp-gopls (same as above)

2. 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

3. Add the following to the mcpServers section:

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

   Or with custom workspace:

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

4. Restart Claude Desktop

• Go 1.24.3+
• gopls (Go language server)

MIT