Merge pull request #7 from imprvhub/6-instructions-for-running-this-in-docker

Co-authored-by: nilsreichardt <[email protected]>
Original implementation and GCP deploy process by @nilsreichardt (see referenced commits)

Author: imprvhub

Dockerfile

@@ -26,4 +26,6 @@ ENV PATH="/app/.venv/bin:$PATH"
 COPY --from=uv /app /app/
 ENV PYTHONPATH=/app
 
-ENTRYPOINT ["mcp-domain-availability"]
+EXPOSE 8080
+
+ENTRYPOINT ["python", "-m", "mcp_domain_availability.main"]

README.md

@@ -168,6 +168,58 @@ uv sync
 uv run src/mcp_domain_availability/main.py
 ```
 
+### Deploying with Docker to Google Cloud Run
+
+You can deploy this service to Google Cloud Run using the provided Dockerfile and deployment script.
+
+**Prerequisites:**
+- [Google Cloud SDK](https://cloud.google.com/sdk/docs/install) installed and authenticated (`gcloud auth login`).
+- [Docker](https://docs.docker.com/get-docker/) installed and running.
+- A Google Cloud Project with the Cloud Run and Container Registry APIs enabled.
+
+#### Using the Deployment Script
+
+The easiest way to deploy is to use the `deploy.sh` script.
+
+1.  **Edit the script:**
+    Open `deploy.sh` and replace `...` with your Google Cloud `PROJECT_ID`. You can also change the `REGION` if needed.
+
+2.  **Run the script:**
+    Make the script executable and run it.
+    ```sh
+    chmod +x deploy.sh
+    ./deploy.sh
+    ```
+    The script will build the Docker image, push it to Google Container Registry, and deploy it to Cloud Run.
+
+#### Manual Deployment
+
+Alternatively, you can run the commands manually.
+
+1.  **Set environment variables:**
+    ```sh
+    export PROJECT_ID="<YOUR_PROJECT_ID>"
+    export REGION="<YOUR_REGION>" # e.g., us-central1
+    export IMAGE="gcr.io/$PROJECT_ID/mcp-domain-availability:latest"
+    ```
+
+2.  **Build and push the Docker image:**
+    ```sh
+    docker buildx build --platform linux/amd64 -t $IMAGE --push .
+    ```
+
+3.  **Deploy to Google Cloud Run:**
+    ```sh
+    gcloud run deploy mcp-domain-availability \
+      --image $IMAGE \
+      --region $REGION \
+      --platform managed \
+      --allow-unauthenticated \
+      --port 8080 \
+      --project $PROJECT_ID
+    ```
+
+
 ### How It Works
 
 The MCP Domain Availability Checker uses multiple verification methods to determine domain availability:

deploy.sh

@@ -0,0 +1,15 @@
+REGION="europe-west1"
+PROJECT_ID="..."
+# Need to be exported for sudo to work
+export IMAGE="gcr.io/$PROJECT_ID/mcp-domain-availability:latest"
+
+sudo docker buildx build --platform linux/amd64 -t $IMAGE --push .
+sudo docker push $IMAGE
+
+gcloud run deploy mcp-domain-availability \
+    --image $IMAGE \
+    --region $REGION \
+    --platform managed \
+    --allow-unauthenticated \
+    --port 8080 \
+    --project $PROJECT_ID

src/mcp_domain_availability/main.py

@@ -2,6 +2,7 @@
 import socket
 import time
 import re
+import os
 from typing import Dict, List, Tuple, Optional
 from concurrent.futures import ThreadPoolExecutor
 
@@ -17,7 +18,7 @@
 
 from mcp.server.fastmcp import FastMCP
 
-mcp = FastMCP("Domain Availability Checker")
+mcp = FastMCP("Domain Availability Checker", host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))
 
 POPULAR_TLDS = [
     "com", "net", "org", "io", "ai", "app", "dev", "co", "xyz", "me", "info", "biz"
@@ -332,4 +333,7 @@ async def check_domain(domain_query: str) -> Dict:
     except Exception as e:
         return {
             "error": f"Failed to check domain: {str(e)}"
-        }
+        }
+    
+if __name__ == "__main__":
+     mcp.run(transport="sse")