# gopls-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/xieyuschen/gopls-mcp  
**GitHub Stars:** 57  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gopls-mcp

## Description
Semantic code analysis for Go using gopls - language-aware navigation, definitions, references

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "gopls-mcp": {
    "url": "https://gopls-mcp.org"
  }
}
```

## Documentation & README

# gopls-mcp

Give your AI Agent the compiler's brain, not a text searcher.

Documentation: https://gopls-mcp.org

gopls-mcp delivers type-checker-level semantic analysis directly to your LLM.
Unlike text search, it resolves Go's type system — interface satisfaction, cross-package identity, and shadowed scopes — with the same precision as the compiler.

Where it pays off most is on **semantic tasks**: finding all concrete types that implement an interface, tracing call hierarchies, and mapping package dependencies. A [benchmark](https://github.com/xieyuschen/gopls-mcp/blob/HEAD/benchmark/) over 11 tasks shows gopls-mcp uses 2–4× fewer tool calls and finishes faster than grep-based navigation on those tasks. For simple same-file lookups, plain bash/grep remains equally effective and carries less overhead.

## Install

### Claude Code (plugin — recommended)

```
/plugin marketplace add https://github.com/xieyuschen/gopls-mcp.git
/plugin install gopls-mcp
```

The plugin automatically installs the binary and injects the routing skill — no manual setup required.

### Codex (plugin — recommended)

```bash
codex plugin marketplace add https://github.com/xieyuschen/gopls-mcp.git
codex plugin add gopls-mcp
```

### Manual install (all clients)

**Linux / macOS:**
```bash
curl -sSL https://gopls-mcp.org/install.sh | bash
```

**Windows (PowerShell):**
```powershell
irm https://gopls-mcp.org/install.ps1 | iex
```

Then follow the per-client setup at https://gopls-mcp.org/quick-start.

## Contribute

The project is actively developing, and feel free to raise PRs or issues if you find anything to improve.
AI generated code will also be accepted but do remember to narrow the change to a specific feature for reviewer to quickly review them.

*Disclaimer*: gopls-mcp is a fork of [gopls](https://tip.golang.org/gopls/) and is a community-driven project. It is not an official Go team product and is not affiliated with or endorsed by Google LLC. This project is licensed under the same BSD license as its [upstream](https://go.googlesource.com/tools) source.