Fast MCP 3.0 and health endpoint

Author: Knucklessg1

.dockerignore

@@ -3,3 +3,10 @@
 pytest.ini
 ./tests/
 Dockerfile
+debug.Dockerfile
+./scripts/
+./mcp/
+./genius_agent.egg-info/
+./build/
+./.ruff_cache/
+./.git/

.pre-commit-config.yaml

@@ -27,7 +27,7 @@ repos:
     hooks:
     - id: black
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.13
+    rev: v0.14.14
     hooks:
       - id: ruff
         types_or: [ python, pyi, jupyter ]

audio_transcriber/audio_transcriber_mcp.py

@@ -11,6 +11,8 @@
 import requests
 from pydantic import Field
 from eunomia_mcp.middleware import EunomiaMcpMiddleware
+from starlette.requests import Request
+from starlette.responses import JSONResponse
 from fastmcp import FastMCP, Context
 from fastmcp.server.auth.oidc_proxy import OIDCProxy
 from fastmcp.server.auth import OAuthProxy, RemoteAuthProvider
@@ -56,6 +58,10 @@
 
 
 def register_tools(mcp: FastMCP):
+    @mcp.custom_route("/health", methods=["GET"])
+    async def health_check(request: Request) -> JSONResponse:
+        return JSONResponse({"status": "OK"})
+
     @mcp.tool(
         annotations={
             "title": "Transcribe Audio",

compose.yml

@@ -5,7 +5,7 @@ services:
     # build: . # Debug
     container_name: audio-transcriber-mcp
     hostname: audio-transcriber-mcp
-    command: ["audio-transcriber-mcp"]
+    command: [ "audio-transcriber-mcp" ]
     extra_hosts:
       - "host.docker.internal:host-gateway"
     logging:
@@ -21,13 +21,19 @@ services:
       - "OPENAI_API_KEY=llama"
     ports:
       - "8014:8014"
+    healthcheck:
+      test: [ "CMD", "python3", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8014/health')" ]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
 
   audio-transcriber-agent:
     image: docker.io/knucklessg1/audio-transcriber:latest
     # build: . # Debug
     container_name: audio-transcriber-agent
     hostname: audio-transcriber-agent
-    command: ["audio-transcriber-agent"]
+    command: [ "audio-transcriber-agent" ]
     extra_hosts:
       - "host.docker.internal:host-gateway"
     depends_on:
@@ -50,3 +56,9 @@ services:
       - "ENABLE_WEB_UI=True"
     ports:
       - "9014:9014"
+    healthcheck:
+      test: [ "CMD", "python3", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:9014/health')" ]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s