mcp-gopls

MCP LSP Go

A Model Context Protocol (MCP) server that allows AI assistants like Claude to interact with Go's Language Server Protocol (LSP) and benefit from advanced Go code analysis features.

Overview

This MCP server helps AI assistants to:

Use LSP to analyze Go code
Navigate to definitions and find references
Check code diagnostics
Get hover information for symbols
Get completion suggestions

Architecture

This project uses the mark3labs/mcp-go library to implement the Model Context Protocol. The MCP integration enables seamless communication between AI assistants and Go tools.

The server communicates with gopls, the official language server for Go, via the Language Server Protocol (LSP).

Features

LSP Integration: Connection to Go's Language Server Protocol for code analysis
Code Navigation: Finding definitions and references in the code
Code Quality: Getting diagnostics and errors
Advanced Information: Hover information and completion suggestions

Project Structure

.
├── cmd
│   └── mcp-gopls        # Application entry point
├── pkg
│   ├── lsp             # LSP client to communicate with gopls
│   │   ├── client      # LSP client implementation
│   │   └── protocol    # LSP protocol types and features
│   ├── server          # MCP server
│   └── tools           # MCP tools exposing LSP features

Installation

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

Add to Cursor

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

MCP Tools

The MCP server provides the following tools:

Tool	Description
`go_to_definition`	Navigate to the definition of a symbol
`find_references`	Find all references to a symbol
`check_diagnostics`	Get diagnostics for a file
`get_hover_info`	Get detailed information about a symbol
`get_completion`	Get completion suggestions at a position
`analyze_coverage`	Analyze test coverage for Go code

Usage Example

Using the server with AI assistants that support MCP:

# Ask the AI to get information about the code
Can you find the definition of the `ServeStdio` function in this project?

# Ask for diagnostics
Are there any errors in my main.go file?

# Ask for information about a symbol
What does the Context.WithTimeout function do in Go?

Development

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

Prerequisites

Go 1.21 or higher
gopls installed (go install golang.org/x/tools/gopls@latest)

Integration with Ollama

This MCP server can be used with any tool that supports the MCP protocol. For Ollama integration:

Make sure Ollama is running
The MCP server runs independently and communicates through stdin/stdout
Configure your client to use the MCP server as a tool provider

License

Apache License 2.0

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

模型上下文协议 (MCP) 服务器允许像 Claude 这样的 AI 助手与 Go 的语言服务器协议 (LSP) 交互并受益于高级 Go 代码分析功能。

Related MCP Servers

Aligo SMS MCP Server
hongsw
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that allows AI agents like Claude to interact with the Aligo SMS API to send text messages and retrieve related information.
Last updated -
1
JavaScript
MIT License
mcp-server-leetcode
doggybee
A
security
A
license
A
quality
A Model Context Protocol (MCP) server for LeetCode that enables AI assistants to access LeetCode problems, user information, and contest data.
Last updated -
7
29
23
TypeScript
MIT License
MCP Starter
instructa
A
security
A
license
A
quality
A foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.
Last updated -
1
28
TypeScript
MIT License
Scenario Word
HyunJuHwan
A
security
F
license
A
quality
A Model Context Protocol (MCP) server that allows Claude AI to interact with custom tools, enabling extension of Claude's capabilities through the MCP framework.
Last updated -
TypeScript

View all related MCP servers