GoMCP — Gin-like Framework for MCP Servers in Go

@zhangpanda

About GoMCP — Gin-like Framework for MCP Servers in Go

The fast, idiomatic way to build MCP servers in Go. Struct-tag auto schema, middleware chain, tool groups, auth, adapters for Gin/OpenAPI/gRPC, async tasks, Inspector UI, and more.

#go #golang #mcp #framework #gin #openapi #grpc

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gomcp": {
      "command": "go",
      "args": [
        "run",
        "github.com/zhangpanda/gomcp/examples/basic@latest"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is GoMCP?

GoMCP is a framework for building Model Context Protocol (MCP) servers in Go, designed as "Gin for MCP." It lets developers create servers that AI applications like Claude Desktop, Cursor, Kiro, and VS Code Copilot can use to call external tools, read data sources, and use prompt templates.

How to use GoMCP?

Install via go get github.com/zhangpanda/gomcp, then create a server with gomcp.New("name", "version"), register tools using s.ToolFunc(), and start a transport such as s.Stdio(). Use struct tags (e.g., mcp:"required,desc=...") to define parameter schemas with automatic validation.

Core features of GoMCP

Struct-tag auto schema generation and validation
Typed handlers with automatic parameter parsing and validation
Middleware chain: Logger, Recovery, Auth, RateLimit, OTel
Tool groups with prefix naming and group-level middleware
Adapters for Gin, OpenAPI/Swagger, and gRPC services
Built-in Bearer, API Key, Basic auth with RBAC

Use cases of GoMCP

Building MCP servers for AI-powered tool calling
Importing existing Gin web routes as MCP tools in one line
Generating MCP tools from OpenAPI/Swagger documentation
Exposing gRPC service methods as MCP tools
Developing async task tools with polling and cancellation support

FAQ from GoMCP

What Go version does GoMCP require?

Go ≥ 1.25 is required.

What MCP protocol version is supported?

2024-11-05, with backward compatibility for 2025-11-25.

Does GoMCP have built-in authentication?

Yes: BearerAuth (JWT), APIKeyAuth, BasicAuth, plus RBAC via RequireRole and RequirePermission on tool groups.

What transports does GoMCP support?

stdio (for Claude Desktop, Cursor, Kiro) and Streamable HTTP with SSE.

Is there a testing utility included?

Yes, the mcptest package provides an in-memory client for unit testing with snapshot support.

Frequently asked questions

What Go version does GoMCP require?

Go ≥ 1.25 is required.

What MCP protocol version is supported?

2024-11-05, with backward compatibility for 2025-11-25.

Does GoMCP have built-in authentication?

Yes: BearerAuth (JWT), APIKeyAuth, BasicAuth, plus RBAC via RequireRole and RequirePermission on tool groups.

What transports does GoMCP support?

stdio (for Claude Desktop, Cursor, Kiro) and Streamable HTTP with SSE.

Is there a testing utility included?

Yes, the `mcptest` package provides an in-memory client for unit testing with snapshot support.

Comments

Basic information

More Developer Tools MCP servers

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.

Skilder.ai

skilder.ai

Run skills and MCP tools like production software: versioned, composed into roles, distributed to every agent from one governed library.

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.

directree

coburn2716

directree MCP server — query the honest software directory from any AI assistant

Reelier

Maxime Houle

Agents make claims. Reelier writes receipts — record an agent's tool-call workflow once, replay it deterministically at 0 tokens, and diff runs to catch drift.