go-review-mcp

A Model Context Protocol (MCP) server that provides real-time access to official Go style guides for intelligent code review.

Go Review MCP fetches the latest style guides directly from official and recommended sources:

- Google Go Style Guide
- Google Go Style Decisions
- Google Go Best Practices

go install github.com/BrunoKrugel/go-review-mcp@latest

git clone https://github.com/BrunoKrugel/go-review-mcp.git cd go-review-mcp make build

{ "mcpServers": { "go-review": { "command": "go-review-mcp", "args": [] } } }

If installed from source, use the full path to the binary:

{ "mcpServers": { "go-review": { "command": "/path/to/go-review-mcp/bin/go-review-mcp", "args": [] } } }

{ "mcpServers": { "go-review": { "command": "go-review-mcp", "args": [] } } }

{ "go-review-mcp": { "type": "stdio", "command": "go-review-mcp", "timeout": 120, "disabled": false }, }

HTTP Mode (for testing with MCP Inspector)

# Start server in HTTP mode go-review-mcp --transport http --port 8080 # Or with environment variable TRANSPORT=http PORT=8080 go-review-mcp

npx @modelcontextprotocol/inspector http://localhost:8080/mcp

Use the review_code prompt with your Go code

Use get_guide_topic for focused advice on topics like "naming" or "errors"

Guides are automatically fetched on first use and cached for 24 hours.

Use search_live_guide to find specific content across all guides

Please review this Go code: [paste your code]

Check the naming conventions in this code

Search the style guides for information about error wrapping

Show me all guidelines about concurrency from the style guides

The following topics are automatically indexed across all guides:

- naming- Naming conventions and identifier rules
- errors- Error handling and error wrapping patterns
- concurrency- Goroutines, channels, mutexes, context usage
- testing- Test structure, table-driven tests, best practices
- interfaces- Interface design and usage patterns
- formatting- Code formatting and style
- comments- Documentation and comment conventions
- imports- Import organization and grouping
- context- Context.Context usage and patterns

The server supports configuration through environment variables:

- TRANSPORT- Transport mode:stdio(default) orhttp
- PORT- HTTP port when using http transport (default: 8080)
- CACHE_TTL- Cache duration for fetched guides (default: 24h)
- Lazy Fetching: Style guides are automatically fetched on first tool use (no manual initialization needed)
- Content Parsing: Guides are parsed into structured sections with automatic topic indexing
- Unified Search: All search and topic queries automatically scan across all fetched guides
- MCP Integration: Simple tools and prompts are exposed via the Model Context Protocol

- Auto-Fetch on Demand: Guides are fetched lazily on first use — no manual fetch step required
- Concurrent Fetching: All guides are fetched in parallel for fast initialization
- Smart Caching: 24-hour cache reduces network requests and improves performance
- Topic Indexing: Automatic categorization of content by topics (naming, errors, concurrency, etc.)
- No Configuration: Works out of the box - no need to choose which guides to use

┌─────────────────┐ │ AI Assistant │ │ (Claude, etc.) │ └────────┬────────┘ │ MCP Protocol (stdio/http) ┌────────▼──────────────────────┐ │ Go Review MCP Server │ │ - 3 Tools │ │ - 6 Prompts │ │ - Concurrent HTTP Fetcher │ │ - 24h Cache (in-memory) │ │ - Content Parser │ │ - Topic Indexer │ └────────┬──────────────────────┘ │ HTTPS (parallel) ┌────────▼──────────────────────┐ │ Official Style Guide Sources │ │ ├─ Google Go Guide │ │ ├─ Google Go Decisions │ │ ├─ Google Go Best Practices │ │ └─ Uber Go Style Guide │ └───────────────────────────────┘

- On-Demand Fetch: First tool call triggers concurrent fetch of all 4 guides
- Parsing: Each guide is parsed into sections with metadata
- Indexing: Sections are automatically categorized by topics
- Query: Search and topic tools scan all indexed content
- Caching: Results are cached for 24 hours to improve performance

- Go 1.21 or later
- Internet connection for fetching live guides (embedded rules work offline)

MIT License - see LICENSE file for details

Contributions are welcome! Please feel free to submit a Pull Request.

- Google Go Style Guide- CC-BY-3.0
- Uber Go Style Guide- MIT

Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar