Summary
This hooks Claude directly into gopls, the official Go language server, to give your AI semantic understanding of Go codebases instead of crude text search. You get precise operations like jump to definition, find references, and symbol lookup that respect Go's type system and package boundaries. Reach for this when you're working with large Go projects and need Claude to understand call graphs, interface implementations, or cross-package dependencies without dumping entire files into context. It's a fork of the upstream gopls tooling, repackaged as an MCP server, so you're getting the same analysis that powers VS Code and other Go editors.
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
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 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)
codex plugin marketplace add https://github.com/xieyuschen/gopls-mcp.git
codex plugin add gopls-mcp
Manual install (all clients)
Linux / macOS:
curl -sSL https://gopls-mcp.org/install.sh | bash
Windows (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 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 source.
Featured
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →