Gopls Go Language Server

by Yantrio

231 downloads Not rated yet
GitHub

About

# MCP-GOPLS An MCP (Model Context Protocol) server that wraps gopls to provide Go language server features. > ⚠️ **WARNING**: This entire project was generated by [Claude Code](https://claude.ai/code) without human code review. While it passes tests and appears functional, please use with **EXTREME CAUTION** in…

Explore

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)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Gopls Go Language Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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

export GOPLS_PATH=/path/to/gopls
export MCP_GOPLS_WORKSPACE=/path/to/project
mcp-gopls


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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

MCP-GOPLS

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.

Features

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)

Installation

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

Integration with Claude

Claude Code

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:

   claude restart

4. Verify installation:

   claude mcp list

Claude Desktop

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

Usage

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.