关于 gopls-mcp
gopls-mcp 是基于 gopls 的 MCP 服务,为 AI Agent 提供 Go 代码的语义分析能力,包括跳转定义、查找引用和接口实现查询。它面向需要类型级精度的 Go 开发场景,是 gopls 的社区分支。
主要功能
- 01基于 gopls 的类型感知代码分析
- 02查找接口的所有具体实现类型
- 03追踪调用层次结构
- 04分析包之间的依赖关系
- 05提供 Claude Code 与 Codex 插件安装方式
适用场景
- 01在大型 Go 项目中查找接口的实现类型
- 02让编码 Agent 追踪函数调用链路
- 03梳理跨包的依赖关系
MCP 相关
gopls-mcp 作为 MCP 服务运行,把 gopls 的语义分析结果以工具形式提供给 MCP 客户端,用于导航、定义和引用查询。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
gopls-mcp
为你的 AI Agent 装上编译器的大脑,而不是文本搜索器。
gopls-mcp 可将类型检查器级别的语义分析直接提供给你的大模型。 与文本搜索不同,它能解析 Go 的类型系统,包括接口实现、跨包类型身份和被遮蔽的作用域,精度与编译器相同。
它最适合处理语义任务:查找所有实现某个接口的具体类型、追踪调用层级,以及梳理包依赖关系。一项针对 11 个任务的基准测试表明,在这些任务上,与基于 grep 的导航方式相比,gopls-mcp 使用的工具调用次数减少了 2–4 倍,完成速度也更快。对于简单的同文件查找,普通 bash/grep 同样有效,而且开销更低。
安装
Claude Code(插件 — 推荐)
/plugin marketplace add https://github.com/xieyuschen/gopls-mcp.git
/plugin install gopls-mcp
该插件会自动安装二进制文件并注入路由技能,无需手动设置。
Codex(插件 — 推荐)
codex plugin marketplace add https://github.com/xieyuschen/gopls-mcp.git
codex plugin add gopls-mcp
手动安装(所有客户端)
Linux / macOS:
curl -sSL https://gopls-mcp.org/install.sh | bash
Windows(PowerShell):
irm https://gopls-mcp.org/install.ps1 | iex
然后按照 https://gopls-mcp.org/quick-start 中对应客户端的说明进行设置。
贡献
本项目正在积极开发中。如果你发现任何可改进之处,欢迎提交 PR 或问题。 也欢迎提交 AI 生成的代码,但请记得将更改范围限定在特定功能内,以便审阅者快速审查。
免责声明:gopls-mcp 是 gopls 的一个分支,也是一个由社区驱动的项目。它不是 Go 团队的官方产品,也未与 Google LLC 建立关联或获得其认可。本项目采用与其上游源代码相同的 BSD 许可证。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。