GoMCP — Gin-like Framework for MCP Servers in Go

@zhangpanda

Basic information

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

GoMCP — Gin-like Framework for MCP Servers in Go 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"
      ]
    }
  }
}

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

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

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

More Developer Tools MCP servers

OrangePro

Aamir Siddiqui

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

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.

Jaybird Digital

Steve Wheeler

Jaybird Digital lets you build a website for you in the conversation. Tell your ai about your business and what you want, and it writes the pages and saves them to Jaybird. You get a link to view the site right away, wi

Final POS – Custom POS Builder

Final Commerce

Build custom POS apps with your AI agent. Final's MCP server lets developers scaffold checkout flows, adapt vetted screen blueprints for counter POS, self-checkout kiosks, restaurant ordering and payment terminals, previ

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U