mcp-gopls

概述

mcp-gopls 是一个 MCP 服务器，连接 AI 助手与 Go 的强大语言服务器 (gopls)。它提供了一整套 LSP 功能，包括代码导航、诊断、格式化、测试执行、覆盖率分析和 Go 模块管理。相比 gopls 内置的 MCP 实现，该服务器提供了更多开发操作功能，如运行测试、整理模块和分析覆盖率。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• go_to_definition

  Navigate to the definition of a symbol

  试试:Find the definition of function Foo试试:Where is the Bar struct defined?
• find_references

  List all references for a symbol

  试试:Find all references to variable myVar试试:Show me where function baz is used
• check_diagnostics

  Fetch cached diagnostics for a file

  试试:Check diagnostics for main.go试试:Show errors in utils.go
• get_hover_info

  Return hover markdown for a symbol

  试试:Show hover info for function myFunction试试:What does interface Foo contain?
• get_completion

  Return completion labels at a position

  试试:Show completions at the end of this line试试:What can I import here?
• format_document

  Return formatting edits for an entire document

  试试:Format this document试试:Make this code gofmt compliant
• rename_symbol

  Return workspace edits for a rename

  试试:Rename variable oldName to newName试试:Change class name from A to B
• list_code_actions

  List available code actions for a range

  试试:Show available code actions for this function试试:What refactors are possible here?
• search_workspace_symbols

  Search workspace-wide symbols

  试试:Search for all functions named Process试试:Find all structs with Handler in the name
• analyze_coverage

  Run go test with coverage + optional per-function report

  试试:Run coverage for ./pkg/server试试:Test ./pkg/tools with per-function coverage
• run_go_test

  Execute go test for a package/pattern

  试试:Run tests for ./pkg/server试试:Test all integration tests
• run_govulncheck

  Execute govulncheck on the codebase

  试试:Run govulncheck on the entire project试试:Check vulnerabilities in ./pkg/...

可对比工具

安装

# 安装服务器
go install github.com/hloiseau/mcp-gopls/v2/cmd/mcp-gopls@latest

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

FAQ

mcp-gopls 与 gopls 内置 MCP 有何区别？

mcp-gopls 提供更多面向开发的工具，如 go test、覆盖率分析和 go mod tidy，而 gopls 内置 MCP 更侧重于诊断和符号搜索等内省工具。

支持哪些 Go 版本？

已测试兼容 Go 1.25.x 和 gopls@latest。项目积极维护与最新 Go 版本的兼容性。

mcp-gopls 对比