micro--go-micro
fad2fd7af4
* docs: update all four documentation guides and mark Q2 complete - ai-native-services: add WithMCP one-liner, standalone gateway, WebSocket client example, and OpenTelemetry observability section - mcp-security: add OTel distributed tracing, WebSocket authentication (connection-level and per-message), DeniedReason audit field - tool-descriptions: add manual overrides with WithEndpointDocs and export formats section - agent-patterns: add LangChain/LlamaIndex SDK pattern and standalone gateway production pattern with Docker example - Update roadmap: mark Q2 documentation as complete, Q2 at 100% - Update status: reflect all recent completions, shift priorities https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: add agent demo example and blog post Add examples/agent-demo with a multi-service project management app (projects, tasks, team) that demonstrates AI agents interacting with Go Micro services through MCP. Includes seed data and example prompts. Add blog post 4 "Agents Meet Microservices: A Hands-On Demo" walking through the example code and showing cross-service agent workflows. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: enable multiple services in a single binary Remove global state mutations from service and cmd option functions so that configuring one service no longer overwrites another's settings. Key changes: - service/options.go: remove all DefaultXxx global writes from option functions; newOptions() now creates fresh Server, Client, Store, and Cache per service while sharing Registry, Broker, and Transport - cmd/cmd.go: newCmd() uses local copies instead of pointers to package globals; Before() no longer mutates DefaultXxx vars - cmd/options.go: remove global mutations from all option functions - service/service.go: export ServiceImpl type for cross-package use - service/group.go: new Group type for multi-service lifecycle - micro.go: add Start/Stop to Service interface, expose Group and NewGroup convenience function - examples/multi-service: working example with two services https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * docs: highlight multi-service binary support Add multi-service section to README with code example, update features list, add to examples index, and note in status summary. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: unify service API and clean up developer experience - Unified service creation: micro.New("name", opts...) as canonical API - Clean handler registration: service.Handle(handler, opts...) accepts server.HandlerOption args directly, no need to reach through Server() - Unexported serviceImpl: users interact through Service interface only - Service groups use Service interface (not concrete type) - Fixed Stop() to properly propagate BeforeStop/AfterStop errors - Fixed store init: error-level log instead of fatal on init failure - Updated all examples to use consistent patterns - Updated README, getting-started, MCP docs, and guides - Added blog post about the DX cleanup https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * fix: add blog post 5 to blog index Blog post 5 (Developer Experience Cleanup) existed as a file but was missing from the blog index page. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: make micro new generate MCP-enabled services by default - main.go template includes mcp.WithMCP(":3001") by default - Handler template has agent-friendly doc comments with @example tags - Proto template has descriptive field comments - README includes MCP usage, Claude Code config, and tool description tips - Makefile adds mcp-tools, mcp-test, mcp-serve targets - go.mod updated to Go 1.22 - Added --no-mcp flag to opt out of MCP integration - Post-create output shows MCP endpoint URLs https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc --------- Co-authored-by: Claude <noreply@anthropic.com>
184 行
4.3 KiB
Go
184 行
4.3 KiB
Go
package microcli
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"os"
|
|
"os/exec"
|
|
|
|
"github.com/urfave/cli/v2"
|
|
"go-micro.dev/v5/client"
|
|
"go-micro.dev/v5/cmd"
|
|
"go-micro.dev/v5/codec/bytes"
|
|
"go-micro.dev/v5/registry"
|
|
|
|
"go-micro.dev/v5/cmd/micro/cli/new"
|
|
"go-micro.dev/v5/cmd/micro/cli/util"
|
|
|
|
// Import packages that register commands via init()
|
|
_ "go-micro.dev/v5/cmd/micro/cli/build"
|
|
_ "go-micro.dev/v5/cmd/micro/cli/deploy"
|
|
_ "go-micro.dev/v5/cmd/micro/cli/init"
|
|
_ "go-micro.dev/v5/cmd/micro/cli/remote"
|
|
)
|
|
|
|
var (
|
|
// version is set by the release action
|
|
// this is the default for local builds
|
|
version = "5.0.0-dev"
|
|
)
|
|
|
|
func genProtoHandler(c *cli.Context) error {
|
|
cmd := exec.Command("find", ".", "-name", "*.proto", "-exec", "protoc", "--proto_path=.", "--micro_out=.", "--go_out=.", `{}`, `;`)
|
|
cmd.Stdout = os.Stdout
|
|
cmd.Stderr = os.Stderr
|
|
return cmd.Run()
|
|
}
|
|
|
|
func init() {
|
|
cmd.Register([]*cli.Command{
|
|
{
|
|
Name: "new",
|
|
Usage: "Create a new service",
|
|
ArgsUsage: "[name]",
|
|
Action: new.Run,
|
|
Flags: []cli.Flag{
|
|
&cli.BoolFlag{
|
|
Name: "no-mcp",
|
|
Usage: "Disable MCP gateway integration in generated code",
|
|
},
|
|
},
|
|
},
|
|
{
|
|
Name: "gen",
|
|
Usage: "Generate various things",
|
|
Subcommands: []*cli.Command{
|
|
{
|
|
Name: "proto",
|
|
Usage: "Generate proto requires protoc and protoc-gen-micro",
|
|
Action: genProtoHandler,
|
|
},
|
|
},
|
|
},
|
|
{
|
|
Name: "services",
|
|
Usage: "List available services",
|
|
Action: func(ctx *cli.Context) error {
|
|
services, err := registry.ListServices()
|
|
if err != nil {
|
|
return err
|
|
}
|
|
for _, service := range services {
|
|
fmt.Println(service.Name)
|
|
}
|
|
return nil
|
|
},
|
|
},
|
|
{
|
|
Name: "call",
|
|
Usage: "Call a service",
|
|
Flags: []cli.Flag{
|
|
&cli.StringSliceFlag{
|
|
Name: "header",
|
|
Aliases: []string{"H"},
|
|
Usage: "Set request headers (can be used multiple times): --header 'Key:Value'",
|
|
},
|
|
&cli.StringSliceFlag{
|
|
Name: "metadata",
|
|
Aliases: []string{"m"},
|
|
Usage: "Set request metadata (can be used multiple times): --metadata 'Key:Value'",
|
|
},
|
|
},
|
|
Action: func(ctx *cli.Context) error {
|
|
args := ctx.Args()
|
|
|
|
if args.Len() < 2 {
|
|
return fmt.Errorf("Usage: [service] [endpoint] [request]")
|
|
}
|
|
|
|
service := args.Get(0)
|
|
endpoint := args.Get(1)
|
|
request := `{}`
|
|
|
|
if args.Len() == 3 {
|
|
request = args.Get(2)
|
|
}
|
|
|
|
// Create context with metadata if provided
|
|
// Note: This is for the direct 'micro call' command.
|
|
// Dynamic service calls (e.g., 'micro helloworld call') are handled in CallService.
|
|
callCtx := context.TODO()
|
|
callCtx = util.AddMetadataToContext(callCtx, ctx.StringSlice("metadata"))
|
|
callCtx = util.AddMetadataToContext(callCtx, ctx.StringSlice("header"))
|
|
|
|
req := client.NewRequest(service, endpoint, &bytes.Frame{Data: []byte(request)})
|
|
var rsp bytes.Frame
|
|
err := client.Call(callCtx, req, &rsp)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
fmt.Print(string(rsp.Data))
|
|
return nil
|
|
},
|
|
},
|
|
{
|
|
Name: "describe",
|
|
Usage: "Describe a service",
|
|
Action: func(ctx *cli.Context) error {
|
|
args := ctx.Args()
|
|
|
|
if args.Len() != 1 {
|
|
return fmt.Errorf("Usage: [service]")
|
|
}
|
|
|
|
service := args.Get(0)
|
|
services, err := registry.GetService(service)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if len(services) == 0 {
|
|
return nil
|
|
}
|
|
b, _ := json.MarshalIndent(services[0], "", " ")
|
|
fmt.Println(string(b))
|
|
return nil
|
|
},
|
|
},
|
|
// Note: The following commands are registered in their respective packages:
|
|
// - status, logs, stop: remote/remote.go
|
|
// - build: build/build.go
|
|
// - deploy: deploy/deploy.go
|
|
// - init: init/init.go
|
|
}...)
|
|
|
|
cmd.App().Action = func(c *cli.Context) error {
|
|
if c.Args().Len() == 0 {
|
|
return nil
|
|
}
|
|
|
|
v, err := exec.LookPath("micro-" + c.Args().First())
|
|
if err == nil {
|
|
ce := exec.Command(v, c.Args().Slice()[1:]...)
|
|
ce.Stdout = os.Stdout
|
|
ce.Stderr = os.Stderr
|
|
return ce.Run()
|
|
}
|
|
|
|
command := c.Args().Get(0)
|
|
args := c.Args().Slice()
|
|
|
|
if srv, err := util.LookupService(command); err != nil {
|
|
return util.CliError(err)
|
|
} else if srv != nil && util.ShouldRenderHelp(args) {
|
|
return cli.Exit(util.FormatServiceUsage(srv, c), 0)
|
|
} else if srv != nil {
|
|
err := util.CallService(srv, args)
|
|
return util.CliError(err)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
}
|