Deployment
Production-style setups run one service: clawql-mcp-http exposes MCP at /mcp and GraphQL at /graphql on the same port.
Streamable HTTP
From the published package:
PORT=8080 npx -p clawql-mcp clawql-mcp-http
Default local MCP endpoint: http://localhost:8080/mcp, health /healthz. Your real URL depends on port, ingress, or tunneling—configure the client with url, not command.
Optional gRPC (protobuf MCP)
The same registered tools (including CallTool) can be exposed over gRPC in the same process as Streamable HTTP. Set ENABLE_GRPC=1; the server listens on GRPC_PORT (default 50051) using the mcp-grpc-transport package (model_context_protocol.Mcp, grpc.health.v1.Health, optional reflection). Clients must send mcp-protocol-version metadata on protobuf RPCs. Invoking from the shell: packages/mcp-grpc-transport README — Testing and invoking MCP over gRPC. On Kubernetes, the clawql-mcp-http Service publishes HTTP and gRPC (50051) so agents can reach localhost:50051 (or the LoadBalancer IP) without port-forward when gRPC is enabled—see Kubernetes and docs/deploy-k8s.md.
Docker
The repo ships a multi-stage Distroless image (docker/README.md) with dist/, bin/, and providers/ for offline bundled specs. Build, run, and compose examples:
github.com/danielsmithdevelopment/ClawQL/blob/main/docker/README.md
Cloud Run
One-shot script (sets project/region via env):
PROJECT_ID="your-project-id" \
REGION="us-central1" \
bash scripts/deploy-cloud-run.sh
Or with Make:
PROJECT_ID="your-project-id" REGION="us-central1" make deploy-cloud-run
After deploy, agents use https://<mcp-service-url>/mcp. Full options: docs/deploy-cloud-run.md.
Kubernetes
Local MCP on Docker Desktop (namespace clawql, http://localhost:8080/mcp, GHCR image or optional local build) is covered on Kubernetes.
For remote clusters, use Kustomize overlays with image tag injection:
ENV=dev IMAGE=us-central1-docker.pkg.dev/<project>/<repo>/clawql-mcp TAG=<tag> make deploy-k8s
Or install with Helm from charts/clawql-mcp: Helm and docs/helm.md.
Details: docs/deploy-k8s.md. Extended container and manifest notes: docker/README.md.