micro--go-micro
Asim Aslam
1bb25d6e7f
* feat: add agent platform showcase and blog post Add a complete platform example (Users, Posts, Comments, Mail) that mirrors micro/blog, demonstrating how existing microservices become AI-accessible through MCP with zero code changes. Includes blog post "Your Microservices Are Already an AI Platform" walking through real agent workflows: signup, content creation, commenting, tagging, and cross-service messaging. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * refactor: rename handler types to drop redundant Service suffix UserService → Users, PostService → Posts, CommentService → Comments, MailService → Mail. Matches micro/blog naming convention. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * refactor: consolidate top-level directories, reduce framework bloat Move internal/non-public packages behind internal/ or into their parent packages where they belong: - deploy/ → gateway/mcp/deploy/ (Helm charts belong with the gateway) - profile/ → service/profile/ (preset plugin profiles are a service concern) - scripts/ → internal/scripts/ (install script is not public API) - test/ → internal/test/ (test harness is not public API) - util/ → internal/util/ (internal helpers shouldn't be imported externally) Also fixes CLAUDE.md merge conflict markers and updates project structure documentation. All import paths updated. Build and tests pass. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * refactor: redesign model package to match framework conventions Rename model.Database interface to model.Model (consistent with client.Client, server.Server, store.Store). Remove generics in favor of interface{}-based API with reflection. Key changes: - model.Model interface: Register once, CRUD infers table from type - DefaultModel + NewModel() + package-level convenience functions - Schema registered via Register(&User{}), no per-call schema passing - Memory implementation as default (in model package, like store) - memory/sqlite/postgres backends updated for new interface - protoc-gen-micro generates RegisterXModel() instead of generic factory - All docs, blog, and README updated https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc --------- Co-authored-by: Claude <noreply@anthropic.com>
MCP Gateway Helm Chart
Deploy the Go Micro MCP Gateway on Kubernetes. The gateway discovers go-micro services via a registry and exposes them as AI-accessible tools through the Model Context Protocol.
Quick Start
helm install mcp-gateway ./deploy/helm/mcp-gateway \
--set gateway.registry=consul \
--set gateway.registryAddress=consul:8500
Configuration
| Parameter | Description | Default |
|---|---|---|
replicaCount |
Number of gateway replicas | 1 |
image.repository |
Container image | ghcr.io/micro/mcp-gateway |
image.tag |
Image tag (defaults to appVersion) | "" |
gateway.address |
Listen address | :3000 |
gateway.registry |
Registry backend (mdns, consul, etcd) | consul |
gateway.registryAddress |
Registry address | consul:8500 |
gateway.rateLimit |
Requests/second per tool (0=unlimited) | 0 |
gateway.rateBurst |
Rate limit burst size | 20 |
gateway.auth |
Enable JWT authentication | false |
gateway.audit |
Enable audit logging | false |
gateway.scopes |
Per-tool scope requirements | [] |
service.type |
Kubernetes service type | ClusterIP |
service.port |
Service port | 3000 |
ingress.enabled |
Enable ingress | false |
autoscaling.enabled |
Enable HPA | false |
autoscaling.minReplicas |
Minimum replicas | 1 |
autoscaling.maxReplicas |
Maximum replicas | 10 |
Examples
Production with Consul
helm install mcp-gateway ./deploy/helm/mcp-gateway \
--set replicaCount=3 \
--set gateway.registry=consul \
--set gateway.registryAddress=consul.default.svc:8500 \
--set gateway.auth=true \
--set gateway.audit=true \
--set gateway.rateLimit=100 \
--set autoscaling.enabled=true
With Ingress (nginx)
helm install mcp-gateway ./deploy/helm/mcp-gateway \
--set ingress.enabled=true \
--set ingress.className=nginx \
--set ingress.hosts[0].host=mcp.example.com \
--set ingress.hosts[0].paths[0].path=/ \
--set ingress.hosts[0].paths[0].pathType=Prefix \
--set ingress.tls[0].secretName=mcp-tls \
--set ingress.tls[0].hosts[0]=mcp.example.com
With Scopes
helm install mcp-gateway ./deploy/helm/mcp-gateway \
--set gateway.auth=true \
--set 'gateway.scopes[0]=blog.Blog.Create=blog:write' \
--set 'gateway.scopes[1]=blog.Blog.Delete=blog:admin'
Architecture
Kubernetes Cluster
┌──────────────────────────────────────────────────────────┐
│ │
│ ┌─────────┐ MCP ┌─────────────┐ RPC ┌──────┐ │
│ │ Ingress │ ───────> │ MCP Gateway │ ──────> │ Svc │ │
│ │ │ │ (N pods) │ │ Pods │ │
│ └─────────┘ └─────────────┘ └──────┘ │
│ │ │ │
│ v v │
│ ┌──────────┐ │
│ │ Consul │ │
│ │ Registry │ │
│ └──────────┘ │
└──────────────────────────────────────────────────────────┘