feat(mcp): generate plugins tool from protobuf contract

Author: Yakwilik

README.md

@@ -153,6 +153,32 @@ docker compose up -d
 docker compose logs -f service
 ```
 
+### Minimal Local Run
+
+For local `easyp generate`, gRPC testing and MCP smoke you do not need the full observability stack.
+
+```bash
+# 1. Start only postgres and local registry
+# If port 5432 is already occupied, the task uses 5433 by default.
+task up-minimal
+
+# 2. Publish only the plugin images required by easyp.yaml
+task local-push-required
+
+# 3. In a separate terminal run the service from source
+# config.local.yml is tuned for this mode.
+task run-local
+
+# 4. Generate code
+easyp --cfg easyp.yaml mod download
+easyp --cfg easyp.yaml generate
+
+# 5. Optional MCP smoke check
+go run ./cmd/mcp-smoke --endpoint http://localhost:8083/mcp
+```
+
+If you want every plugin image in the local registry, use `task local-push-registry` instead of `task local-push-required`.
+
 ### Health Check
 
 ```bash
@@ -244,7 +270,7 @@ SERVER_HOST=0.0.0.0
 SERVER_PORT_GRPC=8080
 SERVER_PORT_METRIC=8081  
 SERVER_PORT_HEALTH=8082
-SERVER_PORT_GATEWAY=8083
+SERVER_PORT_MCP=8083
 
 # Database
 DB_POSTGRES_DSN="postgres://user:pass@localhost/db"
@@ -263,7 +289,7 @@ server:
     grpc: 8080
     metric: 8081
     health: 8082
-    gateway: 8083
+    mcp: 8083
 db:
   migrate_dir: "migrate"
   driver: "postgres"

Taskfile.yml

@@ -9,6 +9,13 @@ tasks:
     cmds:
       - "docker compose up --build --remove-orphans --detach"
 
+  up-minimal:
+    dir: "{{.USER_WORKING_DIR}}"
+    preconditions:
+      - "test -f docker-compose.yml"
+    cmds:
+      - "sh -c 'EASYP_POSTGRES_PORT=${EASYP_POSTGRES_PORT:-5433} docker compose up -d postgres registry'"
+
   down:
     dir: "{{.USER_WORKING_DIR}}"
     preconditions:
@@ -23,6 +30,17 @@ tasks:
     cmds:
       - "./push.sh localhost:5005 --push"
 
+  local-push-required:
+    dir: "{{.USER_WORKING_DIR}}"
+    preconditions:
+      - "test -f registry/protocolbuffers/go/v1.36.10/Dockerfile"
+      - "test -f registry/grpc/go/v1.5.1/Dockerfile"
+    cmds:
+      - "docker build --platform linux/amd64 -t localhost:5005/protocolbuffers/go:v1.36.10 registry/protocolbuffers/go/v1.36.10"
+      - "docker push localhost:5005/protocolbuffers/go:v1.36.10"
+      - "docker build --platform linux/amd64 -t localhost:5005/grpc/go:v1.5.1 registry/grpc/go/v1.5.1"
+      - "docker push localhost:5005/grpc/go:v1.5.1"
+
   run:
     dir: "{{.USER_WORKING_DIR}}"
     deps:
@@ -32,6 +50,13 @@ tasks:
     cmds:
       - "docker compose logs -f service"
 
+  run-local:
+    dir: "{{.USER_WORKING_DIR}}"
+    preconditions:
+      - "test -f config.local.yml"
+    cmds:
+      - "go run ./cmd/main.go -cfg config.local.yml -log_level debug"
+
   test-mcp:
     dir: "{{.USER_WORKING_DIR}}"
     cmds: