MCP Gopls

🚀 MCP LSP Go 项目

本项目是一个实现模型上下文协议（MCP）的服务器，它能让Claude这类AI助手与Go语言的LSP（语言服务协议）交互，借助先进的代码分析功能，为开发者提供更高效的代码辅助服务。

🚀 快速开始

此MCP服务器可助力AI助手完成一系列操作，如使用LSP分析Go代码、导航到定义并查找引用、检查代码诊断信息、获取符号的悬停信息以及获取完成建议等。与支持MCP的AI助手配合使用时，你可以这样提问：

# 让AI查找项目中的函数定义
你能找到`ServeStdio`函数在这个项目中的定义吗？

# 询问诊断信息
我的main.go文件中有错误吗？

# 获取符号信息
你能告诉我Go中`Context.WithTimeout`函数的作用吗？

✨ 主要特性

• LSP整合：与Go的语言服务协议进行通信。
• 代码导航：查找符号的定义和引用。
• 代码质量：获取文件诊断信息。
• 高级信息：悬停信息和完成建议。

📦 安装指南

安装项目

go install github.com/hloiseaufcms/mcp-gopls/cmd/mcp-gopls@latest

添加到Cursor配置

在你的项目根目录创建或修改~/.config/cursor/tools.json文件，添加以下内容：

{
  "mcpServers": {
    "mcp-gopls": {
      "command": "mcp-gopls"
    }
  }
}

💻 使用示例

基础用法

与支持MCP的AI助手一起使用时，可按如下方式提问：

# 让AI查找项目中的函数定义
你能找到`ServeStdio`函数在这个项目中的定义吗？

# 询问诊断信息
我的main.go文件中有错误吗？

# 获取符号信息
你能告诉我Go中`Context.WithTimeout`函数的作用吗？

📚 详细文档

架构

该项目使用mark3labs/mcp-go库来实现模型上下文协议，MCP集成实现了AI助手与Go工具之间的无缝通信。服务器通过语言服务协议（LSP）与官方的Go语言服务器gopls通信。

项目结构

.
├── cmd
│   └── mcp-gopls        # 应用程序入口点
├── pkg
│   ├── lsp             # LSP客户端，用于与gopls通信
│   │   ├── client      # LSP客户端实现
│   │   └── protocol    # LSP协议类型和功能
│   ├── server          # MCP服务器
│   └── tools           # 提供LSP功能的MCP工具

MCP工具

MCP服务器提供以下工具：

与Ollama的集成

此MCP服务器可以与支持MCP协议的任何工具一起使用。对于Ollama集成：

1. 确保Ollama正在运行。
2. MCP服务器独立运行，并通过标准输入/输出进行通信。
3. 配置客户端将MCP服务器用作工具提供者。

🔧 技术细节

开发

git clone https://github.com/hloiseaufcms/mcp-gopls.git
cd mcp-gopls
go mod tidy
go build -o mcp-gopls cmd/mcp-gopls/main.go
./mcp-gopls

先决条件

• Go 1.21或更高版本。
• 安装gopls（go install golang.org/x/tools/gopls@latest）。

📄 许可证

本项目采用Apache License 2.0许可协议。