micro--go-micro
asimMCP Examples
Examples demonstrating Model Context Protocol (MCP) integration with go-micro.
Examples
hello - Minimal Example ⭐ Start Here
The simplest possible MCP-enabled service. Perfect for learning the basics.
What it shows:
- Automatic documentation extraction from Go comments
- MCP gateway setup with 3 lines
- Ready for Claude Code
Run it:
cd hello
go run main.go
documented - Full-Featured Example
Complete example showing all MCP features with a user service.
What it shows:
- Multiple endpoints (GetUser, CreateUser)
- Rich documentation with examples
- Pre-populated test data
- Production-ready patterns
Run it:
cd documented
go run main.go
Quick Start
1. Write Your Service
Add Go doc comments to your handler methods:
// SayHello greets a person by name. Returns a friendly greeting message.
//
// @example {"name": "Alice"}
func (g *Greeter) SayHello(ctx context.Context, req *HelloRequest, rsp *HelloResponse) error {
rsp.Message = "Hello " + req.Name + "!"
return nil
}
type HelloRequest struct {
Name string `json:"name" description:"Person's name to greet"`
}
2. Register Handler (Auto-Extracts Docs!)
handler := service.Server().NewHandler(new(Greeter))
service.Server().Handle(handler)
3. Start MCP Gateway
go mcp.ListenAndServe(":3000", mcp.Options{
Registry: service.Options().Registry,
})
Testing
HTTP API
# List tools
curl http://localhost:3000/mcp/tools | jq
# Call a tool
curl -X POST http://localhost:3000/mcp/call \
-H "Content-Type: application/json" \
-d '{
"tool": "greeter.Greeter.SayHello",
"input": {"name": "Alice"}
}' | jq
Claude Code (Stdio)
Start MCP server:
micro mcp serve
Add to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"my-services": {
"command": "micro",
"args": ["mcp", "serve"]
}
}
}
Restart Claude Code and ask Claude to use your services!
Features
✅ Automatic Documentation Extraction
Just write Go comments - documentation is extracted automatically:
- Go doc comments → Tool descriptions
- @example tags → Example inputs for AI
- Struct tags → Parameter descriptions
✅ Multiple Transports
- Stdio - For Claude Code (recommended)
- HTTP/SSE - For web-based agents
✅ MCP Command Line
micro mcp serve # Start with stdio
micro mcp serve --address :3000 # Start with HTTP
micro mcp list # List tools
micro mcp test <tool-name> # Test a tool
✅ Zero Configuration
- No manual tool registration
- No API wrappers
- No code generation
- Just write normal Go code!