feat: add helm/**

2026-02-04 02:03:32 +00:00 · 2025-09-18 11:31:01 +08:00
parent 177d797ad2
commit a42e3a2954
17 changed files with 756 additions and 7 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -3,6 +3,9 @@
 .env.*
 !.env.example

+# Production configuration
+values-production.yaml
+
 # Python-generated files
 __pycache__/
 *.py[oc]
--- a/27
+++ b/27
@@ -1,4 +1,4 @@
-.PHONY: i dev prod build clean update
+.PHONY: i dev prod build clean update docker-build docker-run helm-install helm-upgrade helm-uninstall helm-lint

 i:
 	uv sync --all-extras --all-packages $(filter-out i,$(MAKECMDGOALS))
@@ -18,5 +18,30 @@ clean:
 update:
 	uv sync --all-extras --all-packages -U $(filter-out update,$(MAKECMDGOALS))

+docker-build:
+	docker compose build $(filter-out docker-build,$(MAKECMDGOALS))
+
+docker-run:
+	docker compose up -d $(filter-out docker-run,$(MAKECMDGOALS))
+
+# Helm deployment commands
+helm-lint:
+	helm lint helm/mcp-template-python
+
+helm-install:
+	helm install mcp-template-python helm/mcp-template-python
+
+helm-upgrade:
+	helm upgrade mcp-template-python helm/mcp-template-python
+
+helm-install-prod:
+	helm install mcp-template-python helm/mcp-template-python -f values-production.yaml
+
+helm-upgrade-prod:
+	helm upgrade mcp-template-python helm/mcp-template-python -f values-production.yaml
+
+helm-uninstall:
+	helm uninstall mcp-template-python
+
 %:
 	@:
--- a/README.zh.md
+++ b/README.zh.md
@@ -14,13 +14,13 @@
 安装依赖：

 ```bash
-uv sync
+make
 ```

 开发：

 ```bash
-uv run dev
+make dev
 ```

 可通过 <http://127.0.0.1:3001/math/mcp> 访问示例 MCP 接口（Streamable HTTP），或 <http://127.0.0.1:3001/math/compatible/sse> 访问 SSE 接口。
@@ -28,7 +28,7 @@ uv run dev
 通过 `--stdio` 来调用命令行：

 ```bash
-uv run prod --stdio
+make prod -- --stdio
 ```

 ## 部署
@@ -36,13 +36,13 @@ uv run prod --stdio
 生产：

 ```bash
-uv run --no-sync prod
+make prod
 ```

 构建 Python Wheel 包：

 ```bash
-uv build
+make build
 ```

 ## Docker 部署
--- a/helm/mcp-template-python/.helmignore
+++ b/helm/mcp-template-python/.helmignore
@@ -0,0 +1,23 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*.orig
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/
--- a/helm/mcp-template-python/Chart.yaml
+++ b/helm/mcp-template-python/Chart.yaml
@@ -0,0 +1,24 @@
+apiVersion: v2
+name: mcp-template-python
+description: MCP Template Python - A Model Context Protocol server template
+
+# A chart can be either an 'application' or a 'library' chart.
+#
+# Application charts are a collection of templates that can be packaged into versioned archives
+# to be deployed.
+#
+# Library charts provide useful utilities or functions for the chart developer. They're included as
+# a dependency of application charts to inject those utilities and functions into the rendering
+# pipeline. Library charts do not define any templates and therefore cannot be deployed.
+type: application
+
+# This is the chart version. This version number should be incremented each time you make changes
+# to the chart and its templates, including the app version.
+# Versions are expected to follow Semantic Versioning (https://semver.org/)
+version: 0.1.0
+
+# This is the version number of the application being deployed. This version number should be
+# incremented each time you make changes to the application. Versions are not expected to
+# follow Semantic Versioning. They should reflect the version the application is using.
+# It is recommended to use it with quotes.
+appVersion: "latest"
--- a/helm/mcp-template-python/README.md
+++ b/helm/mcp-template-python/README.md
@@ -0,0 +1,232 @@
+# MCP Template Python - Helm Chart 配置说明
+
+## 快速开始
+
+### 1. 基础部署
+
+```bash
+# 验证配置
+make helm-lint
+
+# 开发环境部署
+make helm-install
+
+# 更新部署
+make helm-upgrade
+
+# 卸载
+make helm-uninstall
+```
+
+### 2. 生产环境部署
+
+```bash
+# 首次部署
+make helm-install-prod
+
+# 更新部署
+make helm-upgrade-prod
+```
+
+## 核心配置
+
+### 镜像配置
+
+```yaml
+image:
+  repository: docker.io/mcp-template-python
+  tag: "latest"
+  pullPolicy: IfNotPresent
+```
+
+### 服务配置
+
+```yaml
+service:
+  type: ClusterIP
+  port: 3001
+  targetPort: 3001
+```
+
+### 环境变量
+
+```yaml
+env:
+  MCP_DEFAULT_HOST: "0.0.0.0"
+  MCP_DEFAULT_PORT: "3001"
+```
+
+### 健康检查
+
+```yaml
+livenessProbe:
+  httpGet:
+    path: /health
+    port: http
+  initialDelaySeconds: 30
+
+readinessProbe:
+  httpGet:
+    path: /health
+    port: http
+  initialDelaySeconds: 5
+```
+
+## 生产环境配置要点
+
+### 1. 资源配置（必须设置）
+
+```yaml
+resources:
+  limits:
+    cpu: 500m
+    memory: 512Mi
+  requests:
+    cpu: 250m
+    memory: 256Mi
+```
+
+### 2. 镜像仓库
+
+```yaml
+image:
+  repository: your-registry.com/mcp-template-python
+  tag: "v1.0.0"
+```
+
+### 3. 自动扩展
+
+```yaml
+autoscaling:
+  enabled: true
+  minReplicas: 3
+  maxReplicas: 10
+  targetCPUUtilizationPercentage: 70
+```
+
+### 4. Ingress 配置
+
+```yaml
+ingress:
+  enabled: true
+  className: "nginx"
+  hosts:
+    - host: mcp-template-python.your-domain.com
+      paths:
+        - path: /
+          pathType: ImplementationSpecific
+```
+
+## 配置文件管理
+
+### ConfigMap 配置
+
+```yaml
+configMap:
+  enabled: true
+  data:
+    app.conf: |
+      # 应用配置
+      log_level=info
+      debug=false
+```
+
+### 挂载配置文件
+
+在 `values.yaml` 中添加：
+
+```yaml
+volumeMounts:
+  - name: config
+    mountPath: /app/config
+    readOnly: true
+
+volumes:
+  - name: config
+    configMap:
+      name: mcp-template-python-config
+```
+
+## 安全配置
+
+应用运行在非 root 用户下：
+
+```yaml
+securityContext:
+  runAsNonRoot: true
+  runAsUser: 1000
+  capabilities:
+    drop:
+    - ALL
+```
+
+## 部署前检查清单
+
+### 开发环境
+
+- [ ] 修改 `values.yaml` 中的镜像仓库
+- [ ] 确认端口配置
+- [ ] 设置环境变量
+
+### 生产环境
+
+- [ ] 更新 `values-production.yaml` 中的镜像标签
+- [ ] 设置资源限制和请求
+- [ ] 配置域名和 TLS
+- [ ] 确认副本数量
+- [ ] 检查健康检查路径
+
+## 常用命令
+
+```bash
+# 查看部署状态
+kubectl get pods -l app.kubernetes.io/name=mcp-template-python
+
+# 查看服务
+kubectl get svc mcp-template-python
+
+# 查看日志
+kubectl logs -l app.kubernetes.io/name=mcp-template-python
+
+# 进入容器
+kubectl exec -it deployment/mcp-template-python -- /bin/bash
+
+# 查看配置
+helm get values mcp-template-python
+```
+
+## 故障排除
+
+### 常见问题
+
+1. **Pod 启动失败**
+   - 检查镜像是否存在
+   - 确认资源配置是否合理
+   - 查看 Pod 事件：`kubectl describe pod <pod-name>`
+
+2. **健康检查失败**
+   - 确认应用是否提供 `/health` 端点
+   - 检查端口配置是否正确
+   - 调整探针延迟时间
+
+3. **服务无法访问**
+   - 确认 Service 配置
+   - 检查网络策略
+   - 验证 Ingress 配置
+
+### 获取帮助
+
+```bash
+# 查看 Chart 信息
+helm show chart helm/mcp-template-python
+
+# 查看所有配置选项
+helm show values helm/mcp-template-python
+
+# 验证模板渲染
+helm template mcp-template-python helm/mcp-template-python
+```
+
+---
+
+**注意**：生产环境部署前，请务必更新 `values-production.yaml` 中的资源配置和域名设置。
--- a/helm/mcp-template-python/templates/NOTES.txt
+++ b/helm/mcp-template-python/templates/NOTES.txt
@@ -0,0 +1,22 @@
+1. Get the application URL by running these commands:
+{{- if .Values.ingress.enabled }}
+{{- range $host := .Values.ingress.hosts }}
+  {{- range .paths }}
+  http{{ if $.Values.ingress.tls }}s{{ end }}://{{ $host.host }}{{ .path }}
+  {{- end }}
+{{- end }}
+{{- else if contains "NodePort" .Values.service.type }}
+  export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "mcp-template-python.fullname" . }})
+  export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
+  echo http://$NODE_IP:$NODE_PORT
+{{- else if contains "LoadBalancer" .Values.service.type }}
+     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
+           You can watch its status by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "mcp-template-python.fullname" . }}'
+  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "mcp-template-python.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
+  echo http://$SERVICE_IP:{{ .Values.service.port }}
+{{- else if contains "ClusterIP" .Values.service.type }}
+  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "mcp-template-python.name" . }},app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}")
+  export CONTAINER_PORT=$(kubectl get pod --namespace {{ .Release.Namespace }} $POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}")
+  echo "Visit http://127.0.0.1:8080 to use your application"
+  kubectl --namespace {{ .Release.Namespace }} port-forward $POD_NAME 8080:$CONTAINER_PORT
+{{- end }}
--- a/helm/mcp-template-python/templates/_helpers.tpl
+++ b/helm/mcp-template-python/templates/_helpers.tpl
@@ -0,0 +1,62 @@
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "mcp-template-python.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Create a default fully qualified app name.
+We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
+If release name contains chart name it will be used as a full name.
+*/}}
+{{- define "mcp-template-python.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- if contains $name .Release.Name }}
+{{- .Release.Name | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+{{- end }}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "mcp-template-python.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Common labels
+*/}}
+{{- define "mcp-template-python.labels" -}}
+helm.sh/chart: {{ include "mcp-template-python.chart" . }}
+{{ include "mcp-template-python.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{/*
+Selector labels
+*/}}
+{{- define "mcp-template-python.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "mcp-template-python.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+
+{{/*
+Create the name of the service account to use
+*/}}
+{{- define "mcp-template-python.serviceAccountName" -}}
+{{- if .Values.serviceAccount.create }}
+{{- default (include "mcp-template-python.fullname" .) .Values.serviceAccount.name }}
+{{- else }}
+{{- default "default" .Values.serviceAccount.name }}
+{{- end }}
+{{- end }}
--- a/helm/mcp-template-python/templates/configmap.yaml
+++ b/helm/mcp-template-python/templates/configmap.yaml
@@ -0,0 +1,12 @@
+{{- if .Values.configMap.enabled }}
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ include "mcp-template-python.fullname" . }}-config
+  labels:
+    {{- include "mcp-template-python.labels" . | nindent 4 }}
+data:
+  {{- with .Values.configMap.data }}
+  {{- toYaml . | nindent 2 }}
+  {{- end }}
+{{- end }}
--- a/helm/mcp-template-python/templates/deployment.yaml
+++ b/helm/mcp-template-python/templates/deployment.yaml
@@ -0,0 +1,83 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "mcp-template-python.fullname" . }}
+  labels:
+    {{- include "mcp-template-python.labels" . | nindent 4 }}
+spec:
+  {{- if not .Values.autoscaling.enabled }}
+  replicas: {{ .Values.replicaCount }}
+  {{- end }}
+  selector:
+    matchLabels:
+      {{- include "mcp-template-python.selectorLabels" . | nindent 6 }}
+  template:
+    metadata:
+      {{- with .Values.podAnnotations }}
+      annotations:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      labels:
+        {{- include "mcp-template-python.labels" . | nindent 8 }}
+        {{- with .Values.podLabels }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+    spec:
+      {{- with .Values.imagePullSecrets }}
+      imagePullSecrets:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      serviceAccountName: {{ include "mcp-template-python.serviceAccountName" . }}
+      {{- with .Values.podSecurityContext }}
+      securityContext:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      containers:
+        - name: {{ .Chart.Name }}
+          {{- with .Values.securityContext }}
+          securityContext:
+            {{- toYaml . | nindent 12 }}
+          {{- end }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default .Chart.AppVersion }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.service.port }}
+              protocol: TCP
+          env:
+            {{- range $key, $value := .Values.env }}
+            - name: {{ $key }}
+              value: {{ $value | quote }}
+            {{- end }}
+          {{- with .Values.livenessProbe }}
+          livenessProbe:
+            {{- toYaml . | nindent 12 }}
+          {{- end }}
+          {{- with .Values.readinessProbe }}
+          readinessProbe:
+            {{- toYaml . | nindent 12 }}
+          {{- end }}
+          {{- with .Values.resources }}
+          resources:
+            {{- toYaml . | nindent 12 }}
+          {{- end }}
+          {{- with .Values.volumeMounts }}
+          volumeMounts:
+            {{- toYaml . | nindent 12 }}
+          {{- end }}
+      {{- with .Values.volumes }}
+      volumes:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.nodeSelector }}
+      nodeSelector:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.affinity }}
+      affinity:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.tolerations }}
+      tolerations:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
--- a/helm/mcp-template-python/templates/hpa.yaml
+++ b/helm/mcp-template-python/templates/hpa.yaml
@@ -0,0 +1,32 @@
+{{- if .Values.autoscaling.enabled }}
+apiVersion: autoscaling/v2
+kind: HorizontalPodAutoscaler
+metadata:
+  name: {{ include "mcp-template-python.fullname" . }}
+  labels:
+    {{- include "mcp-template-python.labels" . | nindent 4 }}
+spec:
+  scaleTargetRef:
+    apiVersion: apps/v1
+    kind: Deployment
+    name: {{ include "mcp-template-python.fullname" . }}
+  minReplicas: {{ .Values.autoscaling.minReplicas }}
+  maxReplicas: {{ .Values.autoscaling.maxReplicas }}
+  metrics:
+    {{- if .Values.autoscaling.targetCPUUtilizationPercentage }}
+    - type: Resource
+      resource:
+        name: cpu
+        target:
+          type: Utilization
+          averageUtilization: {{ .Values.autoscaling.targetCPUUtilizationPercentage }}
+    {{- end }}
+    {{- if .Values.autoscaling.targetMemoryUtilizationPercentage }}
+    - type: Resource
+      resource:
+        name: memory
+        target:
+          type: Utilization
+          averageUtilization: {{ .Values.autoscaling.targetMemoryUtilizationPercentage }}
+    {{- end }}
+{{- end }}
--- a/helm/mcp-template-python/templates/ingress.yaml
+++ b/helm/mcp-template-python/templates/ingress.yaml
@@ -0,0 +1,43 @@
+{{- if .Values.ingress.enabled -}}
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: {{ include "mcp-template-python.fullname" . }}
+  labels:
+    {{- include "mcp-template-python.labels" . | nindent 4 }}
+  {{- with .Values.ingress.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  {{- with .Values.ingress.className }}
+  ingressClassName: {{ . }}
+  {{- end }}
+  {{- if .Values.ingress.tls }}
+  tls:
+    {{- range .Values.ingress.tls }}
+    - hosts:
+        {{- range .hosts }}
+        - {{ . | quote }}
+        {{- end }}
+      secretName: {{ .secretName }}
+    {{- end }}
+  {{- end }}
+  rules:
+    {{- range .Values.ingress.hosts }}
+    - host: {{ .host | quote }}
+      http:
+        paths:
+          {{- range .paths }}
+          - path: {{ .path }}
+            {{- with .pathType }}
+            pathType: {{ . }}
+            {{- end }}
+            backend:
+              service:
+                name: {{ include "mcp-template-python.fullname" $ }}
+                port:
+                  number: {{ $.Values.service.port }}
+          {{- end }}
+    {{- end }}
+{{- end }}
--- a/helm/mcp-template-python/templates/service.yaml
+++ b/helm/mcp-template-python/templates/service.yaml
@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "mcp-template-python.fullname" . }}
+  labels:
+    {{- include "mcp-template-python.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  ports:
+    - port: {{ .Values.service.port }}
+      targetPort: {{ .Values.service.targetPort | default .Values.service.port }}
+      protocol: TCP
+      name: http
+  selector:
+    {{- include "mcp-template-python.selectorLabels" . | nindent 4 }}
--- a/helm/mcp-template-python/templates/serviceaccount.yaml
+++ b/helm/mcp-template-python/templates/serviceaccount.yaml
@@ -0,0 +1,13 @@
+{{- if .Values.serviceAccount.create -}}
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: {{ include "mcp-template-python.serviceAccountName" . }}
+  labels:
+    {{- include "mcp-template-python.labels" . | nindent 4 }}
+  {{- with .Values.serviceAccount.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+automountServiceAccountToken: {{ .Values.serviceAccount.automount }}
+{{- end }}
--- a/helm/mcp-template-python/templates/tests/test-connection.yaml
+++ b/helm/mcp-template-python/templates/tests/test-connection.yaml
@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: "{{ include "mcp-template-python.fullname" . }}-test-connection"
+  labels:
+    {{- include "mcp-template-python.labels" . | nindent 4 }}
+  annotations:
+    "helm.sh/hook": test
+spec:
+  containers:
+    - name: wget
+      image: busybox
+      command: ['wget']
+      args: ['{{ include "mcp-template-python.fullname" . }}:{{ .Values.service.port }}']
+  restartPolicy: Never
--- a/helm/mcp-template-python/values.yaml
+++ b/helm/mcp-template-python/values.yaml
@@ -0,0 +1,145 @@
+# Default values for mcp-template-python.
+# This is a YAML-formatted file.
+# Declare variables to be passed into your templates.
+
+# This will set the replicaset count more information can be found here: https://kubernetes.io/docs/concepts/workloads/controllers/replicaset/
+replicaCount: 1
+
+# This sets the container image more information can be found here: https://kubernetes.io/docs/concepts/containers/images/
+image:
+  repository: docker.io/mcp-template-python
+  # This sets the pull policy for images.
+  pullPolicy: IfNotPresent
+  # Overrides the image tag whose default is the chart appVersion.
+  tag: ""
+
+# This is for the secrets for pulling an image from a private repository more information can be found here: https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/
+imagePullSecrets: []
+# This is to override the chart name.
+nameOverride: ""
+fullnameOverride: ""
+
+# This section builds out the service account more information can be found here: https://kubernetes.io/docs/concepts/security/service-accounts/
+serviceAccount:
+  # Specifies whether a service account should be created
+  create: true
+  # Automatically mount a ServiceAccount's API credentials?
+  automount: true
+  # Annotations to add to the service account
+  annotations: {}
+  # The name of the service account to use.
+  # If not set and create is true, a name is generated using the fullname template
+  name: ""
+
+# This is for setting Kubernetes Annotations to a Pod.
+# For more information checkout: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/
+podAnnotations: {}
+# This is for setting Kubernetes Labels to a Pod.
+# For more information checkout: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
+podLabels: {}
+
+podSecurityContext:
+  fsGroup: 1000
+
+securityContext:
+  capabilities:
+    drop:
+    - ALL
+  readOnlyRootFilesystem: false
+  runAsNonRoot: true
+  runAsUser: 1000
+
+# Environment variables
+env:
+  # From .env.example
+  MCP_DEFAULT_HOST: "0.0.0.0"
+  MCP_DEFAULT_PORT: "3001"
+
+# This is for setting up a service more information can be found here: https://kubernetes.io/docs/concepts/services-networking/service/
+service:
+  # This sets the service type more information can be found here: https://kubernetes.io/docs/concepts/services-networking/service/#publishing-services-service-types
+  type: ClusterIP
+  # This sets the ports more information can be found here: https://kubernetes.io/docs/concepts/services-networking/service/#field-spec-ports
+  port: 3001
+  targetPort: 3001
+
+# This block is for setting up the ingress for more information can be found here: https://kubernetes.io/docs/concepts/services-networking/ingress/
+ingress:
+  enabled: false
+  className: ""
+  annotations: {}
+    # kubernetes.io/ingress.class: nginx
+    # kubernetes.io/tls-acme: "true"
+  hosts:
+    - host: chart-example.local
+      paths:
+        - path: /
+          pathType: ImplementationSpecific
+  tls: []
+  #  - secretName: chart-example-tls
+  #    hosts:
+  #      - chart-example.local
+
+resources: {}
+  # We usually recommend not to specify default resources and to leave this as a conscious
+  # choice for the user. This also increases chances charts run on environments with little
+  # resources, such as Minikube. If you do want to specify resources, uncomment the following
+  # lines, adjust them as necessary, and remove the curly braces after 'resources:'.
+  # limits:
+  #   cpu: 100m
+  #   memory: 128Mi
+  # requests:
+  #   cpu: 100m
+  #   memory: 128Mi
+
+# This is to setup the liveness and readiness probes more information can be found here: https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/
+livenessProbe:
+  httpGet:
+    path: /health
+    port: http
+  initialDelaySeconds: 30
+  periodSeconds: 10
+  timeoutSeconds: 5
+  failureThreshold: 3
+
+readinessProbe:
+  httpGet:
+    path: /health
+    port: http
+  initialDelaySeconds: 5
+  periodSeconds: 5
+  timeoutSeconds: 3
+  failureThreshold: 3
+
+# This section is for setting up autoscaling more information can be found here: https://kubernetes.io/docs/concepts/workloads/autoscaling/
+autoscaling:
+  enabled: false
+  minReplicas: 1
+  maxReplicas: 100
+  targetCPUUtilizationPercentage: 80
+  # targetMemoryUtilizationPercentage: 80
+
+# Additional volumes on the output Deployment definition.
+volumes: []
+# - name: foo
+#   secret:
+#     secretName: mysecret
+#     optional: false
+
+# Additional volumeMounts on the output Deployment definition.
+volumeMounts: []
+# - name: foo
+#   mountPath: "/etc/foo"
+#   readOnly: true
+
+nodeSelector: {}
+
+tolerations: []
+
+affinity: {}
+
+# ConfigMap configuration
+configMap:
+  enabled: true
+  data: {}
+    # Add any configuration files here
--- a/uv.lock
+++ b/uv.lock
@@ -408,7 +408,7 @@ dev = [

 [package.metadata]
 requires-dist = [
-    { name = "click", specifier = ">=8.2.1" },
+    { name = "click", specifier = ">=8.0.0" },
    { name = "fastapi", extras = ["standard"], specifier = ">=0.115.0" },
    { name = "mcp", extras = ["cli"], specifier = ">=1.10.0" },
    { name = "pydantic", specifier = ">=2.11.7" },