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.
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.
Basic information
More Developer Tools MCP servers
TaskerArmy Agent
TaskerArmyAsk Claude or ChatGPT what Shopify theme optimization tasks are pending on your store, a remote MCP server for TaskerArmy Agent accounts.
Meticulous
MeticulousMCP server and skills to connect to the Meticulous UI testing platform.
OrangePro
Aamir SiddiquiOrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.
Skilder.ai
skilder.aiRun skills and MCP tools like production software: versioned, composed into roles, distributed to every agent from one governed library.
MCP Server By TestMu AI
TestMu AITestMu AI MCP Server lets developers run, debug, and triage tests through natural language directly from their IDE (Cursor, Claude, GitHub Copilot, and other MCP clients). It exposes five tools — HyperExecute (test orche
Comments