Migration Guides on Go Micro

Add MCP to Existing Services

Mon, 01 Jan 0001 00:00:00 +0000

Add MCP to Existing Services

You have a working go-micro service and want to make it accessible to AI agents via MCP. This guide covers the three approaches, from simplest to most flexible.

Option 1: One-Line Setup (Recommended)

Add a single option to your service constructor:

import "go-micro.dev/v6/gateway/mcp"

func main() {
 service := micro.NewService("myservice",
 mcp.WithMCP(":3001"), // Add this line
 )
 service.Init()
 // ... register handlers as before
 service.Run()
}

That’s it. Your service now exposes all registered handlers as MCP tools at http://localhost:3001/mcp/tools.

Migrating from gRPC

Mon, 01 Jan 0001 00:00:00 +0000

Step-by-step guide to migrating existing gRPC services to Go Micro.

Why Migrate?

Go Micro adds:

Built-in service discovery
Client-side load balancing
Pub/sub messaging
Multiple transport options
Unified tooling

You keep:

Your proto definitions
gRPC performance (via gRPC transport)
Type safety
Streaming support

Migration Strategy

Phase 1: Parallel Running

Run Go Micro alongside existing gRPC services

Phase 2: Gradual Migration

Migrate services one at a time

Migrating from v5 to v6

Mon, 01 Jan 0001 00:00:00 +0000

v6 is a small, mechanical upgrade. The bulk of it is the Go module path; the behavioral changes are two, both with a one-line fix.

1. Module path: `go-micro.dev/v6`

Go puts the major version in the import path, so every import changes:

// before
import "go-micro.dev/v5"
import "go-micro.dev/v5/server"

// after
import "go-micro.dev/v6"
import "go-micro.dev/v6/server"

A repo-wide find/replace does it:

grep -rl 'go-micro.dev/v5' --include='*.go' . \
 | xargs sed -i 's|go-micro.dev/v5|go-micro.dev/v6|g'
go mod tidy

Update the CLI too:

Migration Guides on Go Micro

Add MCP to Existing Services

Add MCP to Existing Services

Option 1: One-Line Setup (Recommended)

Migrating from gRPC

Why Migrate?

Migration Strategy

Phase 1: Parallel Running

Phase 2: Gradual Migration

Migrating from v5 to v6

1. Module path: go-micro.dev/v6

1. Module path: `go-micro.dev/v6`