mrjoshuak/godoc-mcp

Overview
godoc-mcp is a Model Context Protocol (MCP) server that provides efficient access to Go documentation. It helps LLMs understand Go projects by providing direct access to package documentation without needing to read entire source files. godoc-mcp can vastly improve the performance of using LLMs to develop in Go by substantially reducing the number of tokens needed to understand and make use of Go packages.
Getting Started
Why Use godoc-mcp?
In a sentence: **godoc-mcp provides a more token efficient way for LLMs to understand Go projects.**
Traditional file-reading approaches require LLMs to process entire source files often many files to understand a single package. godoc-mcp provides several advantages:
1. **Token Efficiency**: Returns only the essential documentation, reducing token usage significantly
2. **Structured Information**: Provides official package documentation in a consistent, well-structured format
3. **Project Navigation**: Smart handling of project structures helps LLMs understand multi-package projects
4. **Integration Ready**: Works alongside other MCP servers, enabling both high-level and detailed code analysis
5. **Performance**: Caching and optimized token usage make godoc-mcp a fast and efficient tool for Go development
6. **Local**: Does not require an internet connection to access documentation
With godoc-mcp, a LLM can get precisely the information it needs without having to read entire source files. Here are the different levels of detail that an LLM can get.
- Documentation for one exported symbol
- The complete source for one symbol
- A list of all exported symbols (the concise documentation)
- A list of all symbols including unexported symbols
- The full documentation for a package
- The entire source for a package
This makes godoc-mcp an essential tool for Go developers using LLMs by enabling LLMs to understand significantly more, and in more detail, about the context than previously possible in any programming language.
Features
The server will:
1. For directories with Go files: Return package documentation
2. For directories without Go files: List available Go packages in subdirectories
3. For import paths: Return standard library or third-party package documentation
- **Efficient Documentation Access**: Retrieves official Go documentation with minimal token usage
- **Smart Package Discovery**: When pointed at a directory without Go files, lists available Go packages in subdirectories
- **Flexible Path Support**:
- Local file paths (e.g., "/full/path/to/mypackage")
- Import paths (e.g., "io", "github.com/user/repo")
- **Automatic Module Context**:
- Creates temporary Go projects when needed
- Automatically sets up module context for external packages
- No manual module setup required for any package documentation
- Handles cleanup of temporary projects
- **Module-Aware**: Supports documentation for third-party packages through working directory context (i.e. it will run go doc from the working directory)
- **Performance Optimized**:
- Built-in response caching
- Efficient token usage through focused documentation retrieval
- Metadata about response sizes
- Smart handling of standard library vs external packages
Examples
In addition to providing documentation while working on coding tasks. godoc-mcp can also be used to explore Go projects and packages. Here are some examples for general prompting: