GoMCP — Gin-like Framework for MCP Servers in Go

Name: GoMCP — Gin-like Framework for MCP Servers in Go
Author: zhangpanda

@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

Basic information

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.

Comments

More Developer Tools MCP servers

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K

JetBrains MCP Proxy Server

JetBrains

A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio

962

MCP Inspector

modelcontextprotocol

Visual testing tool for MCP servers

10.3K

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

2.8K