fix(transport): support both stdio and sse modes via MCP_TRANSPORT env var

- Add MCP_TRANSPORT environment variable to switch between stdio (default) and sse modes
- stdio mode: for Claude Desktop integration (default behavior)
- sse mode: for Google Cloud Run and web deployments
- Update deploy.sh to set MCP_TRANSPORT=sse for Cloud Run
- Update README with transport modes documentation

Author: imprvhub

README.md

@@ -170,12 +170,16 @@ 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.
+The MCP server supports two transport modes:
+- **stdio** (default): For Claude Desktop integration via stdin/stdout
+- **sse**: For HTTP/web deployments like Google Cloud Run
+
+When deploying to Cloud Run, the `MCP_TRANSPORT` environment variable must be set to `sse`.
 
 **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.
+- [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
 
@@ -186,39 +190,41 @@ The easiest way to deploy is to use the `deploy.sh` script.
 
 2.  **Run the script:**
     Make the script executable and run it.
-    ```sh
+```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.
+```
+    The script will build the Docker image, push it to Google Container Registry, and deploy it to Cloud Run with `MCP_TRANSPORT=sse`.
 
 #### Manual Deployment
 
 Alternatively, you can run the commands manually.
 
 1.  **Set environment variables:**
-    ```sh
+```sh
     export PROJECT_ID="<YOUR_PROJECT_ID>"
-    export REGION="<YOUR_REGION>" # e.g., us-central1
+    export REGION="<YOUR_REGION>"
     export IMAGE="gcr.io/$PROJECT_ID/mcp-domain-availability:latest"
-    ```
+```
 
 2.  **Build and push the Docker image:**
-    ```sh
+```sh
     docker buildx build --platform linux/amd64 -t $IMAGE --push .
-    ```
+```
 
 3.  **Deploy to Google Cloud Run:**
-    ```sh
+```sh
     gcloud run deploy mcp-domain-availability \
       --image $IMAGE \
       --region $REGION \
       --platform managed \
       --allow-unauthenticated \
       --port 8080 \
+      --set-env-vars MCP_TRANSPORT=sse \
       --project $PROJECT_ID
-    ```
+```
 
+**Note:** For local Claude Desktop usage, no environment variables are needed. The server defaults to `stdio` transport mode.
 
 ### How It Works
 

deploy.sh

@@ -12,4 +12,5 @@ gcloud run deploy mcp-domain-availability \
     --platform managed \
     --allow-unauthenticated \
     --port 8080 \
+    --set-env-vars MCP_TRANSPORT=sse \
     --project $PROJECT_ID

src/mcp_domain_availability/main.py

@@ -18,7 +18,13 @@
 
 from mcp.server.fastmcp import FastMCP
 
-mcp = FastMCP("Domain Availability Checker", host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))
+TRANSPORT_MODE = os.environ.get("MCP_TRANSPORT", "stdio")
+PORT = int(os.environ.get("PORT", 8080))
+
+if TRANSPORT_MODE == "sse":
+    mcp = FastMCP("Domain Availability Checker", host="0.0.0.0", port=PORT)
+else:
+    mcp = FastMCP("Domain Availability Checker")
 
 POPULAR_TLDS = [
     "com", "net", "org", "io", "ai", "app", "dev", "co", "xyz", "me", "info", "biz"
@@ -44,9 +50,7 @@
 
 TLD_MIN_LENGTH = {
     "com": 2, "net": 2, "org": 2, "info": 2, "biz": 3,
-
     "io": 2, "ai": 2, "co": 3, "me": 3,
-    
     "de": 2, "fr": 2, "it": 2, "es": 2, "nl": 3,
     "ch": 3, "at": 3, "be": 3, "dk": 3, "se": 3,
     "no": 3, "fi": 3, "pl": 3, "cz": 3, "pt": 3,
@@ -55,19 +59,16 @@
     "in": 3, "br": 3, "mx": 3, "ar": 3, "cl": 3,
     "pe": 3, "za": 3, "eg": 3, "ma": 3, "ng": 3,
     "ke": 3,
-    
     "app": 3, "dev": 3, "xyz": 3, "tech": 3,
     "online": 3, "site": 3, "website": 3, "store": 3,
     "shop": 3, "cloud": 3, "digital": 3, "blog": 3,
     "news": 3
 }
 
 def get_min_length_for_tld(tld: str) -> int:
-    """Obtiene la longitud mínima requerida para un TLD"""
     return TLD_MIN_LENGTH.get(tld, 3)
 
 def is_valid_domain_name(base_name: str, tld: str) -> bool:
-    """Valida si un nombre de dominio cumple con las reglas del TLD"""
     min_length = get_min_length_for_tld(tld)
     if len(base_name) < min_length:
         return False
@@ -295,20 +296,6 @@ async def run_domain_checks(domain_part: str) -> Dict:
 
 @mcp.tool()
 async def check_domain(domain_query: str) -> Dict:
-    """
-    Check domain availability. 
-    
-    Usage examples:
-    - "mysite.com --domain" - checks exact domain
-    - "mysite --domain" - checks mysite across all popular TLDs
-    - "test.io --domain" - checks test.io exactly, plus test across all TLDs
-    
-    Args:
-        domain_query (str): Domain to check with --domain flag
-        
-    Returns:
-        Dict containing availability results for the domain and suggested alternatives
-    """
     if '--domain' not in domain_query:
         return {
             "error": "Please use --domain flag. Example: 'mysite.com --domain' or 'mysite --domain'"
@@ -336,4 +323,7 @@ async def check_domain(domain_query: str) -> Dict:
         }
 
 if __name__ == "__main__":
-     mcp.run(transport="sse")
+    if TRANSPORT_MODE == "sse":
+        mcp.run(transport="sse")
+    else:
+        mcp.run()