Skip to content
Go MCP Server Template

Quickstart Guide

Prerequisites

Section titled “Prerequisites”
  • Go 1.25 or higher installed.
  • Git installed.

1. Clone the Template

Section titled “1. Clone the Template”
Terminal window
git clone https://github.com/ghchinoy/mcp-server-go-template.git
cd mcp-server-go-template

2. Run the Server Locally

Section titled “2. Run the Server Locally”
Terminal window
go run .

The server starts immediately on port 8080:

  • MCP Ingress Endpoint: http://localhost:8080/sse
  • OAuth AS Discovery: http://localhost:8080/.well-known/oauth-authorization-server
  • Protected Resource Metadata: http://localhost:8080/.well-known/oauth-protected-resource
  • Health Liveness Check: http://localhost:8080/healthz

3. Generate a Testing Bearer Token

Section titled “3. Generate a Testing Bearer Token”

Generate a 24-hour signed JWT for local tool execution:

Terminal window
make token UID=developer@example.com

4. Run the Integration Tests

Section titled “4. Run the Integration Tests”
Terminal window
make test

All client-server integration tests run using Go’s standard httptest.NewServer and mcp.NewClient.

5. Build Interactively with the Agent Skill

Section titled “5. Build Interactively with the Agent Skill”

To customize tools and integrations without writing boilerplate by hand, open your AI coding assistant (Cursor, OpenCode, Claude Code, Gemini CLI) in this repository and prompt:

“Let’s start building a production-grade MCP server using the Go template.”

The assistant will use the bundled mcp-go-scaffolder skill to guide you through defining typed argument structs, implementing dual-emit handlers, configuring stateless transport multiplexing, and generating integration tests.