go-mcp-server

cbrgm/go-mcp-server

3.4

If you are the rightful owner of go-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Go-based Model Context Protocol (MCP) server providing tea information through tools, resources, and prompts.

Go MCP Server

A Model Context Protocol (MCP) server implementation in Go that provides tea information through tools, resources, and prompts.

Note: This project is for learning purposes only. I built this MCP server from scratch to understand the Model Context Protocol specification. For production use, consider using mcp-go or wait for the official MCP Go SDK to be released (expected end of June 2025).

This MCP server, especially the mcp package, was written with the help of Claude Code using the latest version of the MCP specification (2025-06-21).

Features

  • MCP 2025-03-26 Specification Compliant
  • Multiple Transports: stdio (default), http with SSE
  • Tea Collection: 8 premium teas (Green, Black, Oolong, White)
  • Full MCP Capabilities: Tools, Resources, and Prompts

Quick Start

# Build the binary
go build ./cmd/go-mcp-server

# Run with stdio transport (default)
./go-mcp-server

# Run with HTTP transport
./go-mcp-server -transport http -port 8080

# Test with MCP Inspector
echo '{"jsonrpc":"2.0","method":"initialize","id":1}' | ./go-mcp-server

Usage

The server binary accepts several command line arguments to configure its behavior:

./go-mcp-server [options]

Command Line Arguments

ArgumentTypeDefaultDescription
-transportstringstdioTransport protocol to use (stdio or http)
-portint8080HTTP server port (only used with -transport http)
-request-timeoutduration30sMaximum time to wait for request processing
-shutdown-timeoutduration10sMaximum time to wait for graceful shutdown
-log-levelstringinfoLog level (debug, info, warn, error)
-log-jsonboolfalseOutput logs in JSON format
-server-namestringMCP ServerServer name returned in initialization
-server-versionstring1.0.0Server version returned in initialization

Examples

# Default stdio transport with debug logging
./go-mcp-server -log-level debug

# HTTP transport on custom port with JSON logs
./go-mcp-server -transport http -port 9000 -log-json

# Custom timeouts for production use
./go-mcp-server -transport http -request-timeout 60s -shutdown-timeout 30s

# Custom server identification
./go-mcp-server -server-name "My Tea Server" -server-version "2.0.0"

MCP Capabilities

Tools

  • getTeaNames - List all available teas
  • getTeaInfo - Get detailed tea information and brewing instructions
  • getTeasByType - Filter teas by type (Green Tea, Black Tea, Oolong Tea, White Tea)

Resources

  • menu://tea - Complete tea collection with prices and details

Prompts

  • tea_recommendation - Personalized recommendations based on mood/preferences
  • brewing_guide - Detailed brewing instructions for specific teas
  • tea_pairing - Food pairing suggestions

Tea Collection Example

Try these commands to explore the tea collection:

# List all available teas
echo '{"jsonrpc":"2.0","method":"tools/call","id":1,"params":{"name":"getTeaNames","arguments":{}}}' | ./go-mcp-server

# Get information about a specific tea
echo '{"jsonrpc":"2.0","method":"tools/call","id":2,"params":{"name":"getTeaInfo","arguments":{"name":"earl-grey"}}}' | ./go-mcp-server

# Get all oolong teas
echo '{"jsonrpc":"2.0","method":"tools/call","id":3,"params":{"name":"getTeasByType","arguments":{"type":"Oolong Tea"}}}' | ./go-mcp-server

# Read the complete tea menu resource
echo '{"jsonrpc":"2.0","method":"resources/read","id":4,"params":{"uri":"menu://tea"}}' | ./go-mcp-server

# Get a brewing guide for gyokuro
echo '{"jsonrpc":"2.0","method":"prompts/get","id":5,"params":{"name":"brewing_guide","arguments":{"tea_name":"gyokuro"}}}' | ./go-mcp-server

Web UI

When using HTTP transport, a web status page is available at the root path (/) of the server. This page shows server information, active sessions, and available endpoints.

MCP Client Configuration

Claude Desktop / VS Code / Other MCP Clients

Add this configuration to your MCP client settings:

{
  "mcpServers": {
    "tea": {
      "command": "podman",
      "args": ["run", "-i", "--rm", "ghcr.io/cbrgm/go-mcp-server:v1"]
    }
  }
}

For local development, you can also use:

{
  "mcpServers": {
    "tea": {
      "command": "go",
      "args": ["run", "./cmd/go-mcp-server"],
      "cwd": "/path/to/go-mcp-server"
    }
  }
}

Testing with MCP Inspector

  1. Install: npm install -g @modelcontextprotocol/inspector
  2. Start: npx @modelcontextprotocol/inspector
  3. Connect with command: go run ./cmd/go-mcp-server

License

Apache 2.0