VERIFIED

Gopls

Safety: 55/100

0.0(0)

MCP server exposing Go's LSP (gopls) for AI assistants, enabling code navigation, diagnostics, testing, and refactoring capabilities.

MCP ServersFreemium

Boost this tool

Subscribe to listing upgrades or segmented pushes.

Overview

MCP server exposing Go's LSP (gopls) for AI assistants, enabling code navigation, diagnostics, testing, and refactoring capabilities.

This server provides powerful code analysis and manipulation capabilities. It's safe for read-only operations like code navigation and diagnostics. However, running tests or applying code actions carries a moderate risk of unintended changes and should be carefully reviewed.

Performance depends on the size of the Go workspace and the complexity of the code. Long-running commands may impact responsiveness.

The primary cost is the computational resources used by the server. Consider the cost of running gopls and other tools.

LocalGo66 starsApache-2.0Released 1/7/2026CI/CD

Connections & Capabilities

Connects To

GitHubDocker

Capabilities

ReadWriteExec

Client Compatibility

Claude Desktop

full

Cursor

full

Windsurf

untested

VS Code (Copilot)

full

Quickstart

Install

npx -y @mark3labs/mcp-inspector \

Claude Desktop Config

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

Tools (14)

safe

go_to_definition

Navigates to the definition of a specified symbol.

Read-only operation, no side effects.

safe

find_references

Lists all references to a specified symbol.

Read-only operation, no side effects.

safe

check_diagnostics

Fetches cached diagnostics for a specified file.

Read-only operation, no side effects.

safe

get_hover_info

Returns hover information for a symbol at a given position.

Read-only operation, no side effects.

safe

get_completion

Returns code completion suggestions at a given position.

Read-only operation, no side effects.

moderate

format_document

Formats the specified Go document.

Modifies the document, but generally non-destructive.

high

rename_symbol

Renames a symbol throughout the workspace.

Modifies code structure, potential for errors.

moderate

list_code_actions

Lists available code actions for a given range.

Code actions can modify code, review before applying.

safe

search_workspace_symbols

Searches for symbols within the workspace.

Read-only operation, no side effects.

safe

analyze_coverage

Analyzes code coverage for specified packages.

Read-only analysis, no code modification.

moderate

run_go_test

Executes Go tests for specified packages.

Can modify files (e.g., generate test coverage files).

moderate

run_go_mod_tidy

Runs `go mod tidy` to synchronize the go.mod file.

Modifies go.mod and go.sum, potentially altering dependencies.

safe

run_govulncheck

Runs `govulncheck` to identify known vulnerabilities.

Read-only analysis, no code modification.

safe

module_graph

Generates a module graph of dependencies.

Read-only operation, no side effects.

Security

Auth Method

None

Data Locality

local

Known Risks

!Unintended code modifications via code actions or `go mod tidy`.
!Exposure of sensitive code within the Go workspace.
!Potential vulnerabilities in the underlying `gopls` LSP server.
!Resource exhaustion from long-running commands without proper monitoring.

Safety Score

moderate risk

Positive

+Uses LSP for code analysis, which is generally safe.
+Provides structured logging for auditing.
+Allows configurable runtime parameters.
+Supports progress streaming for long-running commands.

Risks

-Can execute `go test`, `go mod tidy`, and `govulncheck`, which can modify the workspace.
-Exposes code actions that could potentially introduce unintended changes.
-Relies on the security of the underlying `gopls` LSP server.
-Requires access to the Go workspace, potentially exposing sensitive code.

Use Cases

Code Navigation

-Finding the definition of a function or variable.
-Discovering all references to a specific symbol.
-Understanding the call hierarchy of a function.

Code Analysis

-Identifying potential errors and warnings in the code.
-Analyzing code coverage to improve testing.
-Detecting known vulnerabilities in dependencies.

Code Refactoring

-Renaming symbols to improve code clarity.
-Applying code actions to fix common issues.
-Formatting code to adhere to style guidelines.

Dependency Management

-Tidying up the `go.mod` file.
-Visualizing the module graph.
-Ensuring dependencies are up-to-date and secure.

Who Is This For?

Best For

AI assistants needing Go language support.
Automated code analysis and refactoring tools.
Developers using AI to assist with coding tasks.
Teams wanting to integrate Go tooling into their AI workflows.

Not Ideal For

Environments with strict security requirements that prohibit code execution.
Workspaces with extremely large codebases that may overwhelm the server.
Use cases requiring real-time code analysis with minimal latency.

Autonomy & Execution

Default ModeConfigurable

Destructive Tools

The level of autonomy depends on the specific tool being used. Some tools are read-only, while others can modify code. Exercise caution when using tools that can modify code.

StatelessYes

Retry LogicNot documented

ConcurrencySingle-threaded

Production Tip

Monitor the server's logs and resource usage to ensure it's operating within acceptable limits.

FAQ

What is the purpose of mcp-gopls?

It exposes Go's LSP (gopls) to AI assistants via the Model Context Protocol (MCP).

What Go versions are supported?

Go 1.25 and later are supported.

How do I install mcp-gopls?

Use `go install github.com/hloiseau/mcp-gopls/v2/cmd/mcp-gopls@latest`.

How do I configure mcp-gopls for Cursor?

Edit the Cursor settings JSON and add an entry for mcp-gopls with the workspace path.

What is the `--workspace` flag?

It specifies the absolute path to your Go project.

What are the risks of using mcp-gopls?

Potential unintended code modifications and exposure of sensitive code.

How can I monitor the server's activity?

Check the server's logs for errors and resource usage.

Metrics

Discovered2/14/2026

Reviews0

Saved By0 users

Related Tools

Gopls - AI Tool Review & Alternatives | Flaex AI