fix: change http mode to be stateless (#6)

* fix: make http mode stateless

* chore(ci): update pipeline version

Author: daniel-butler-irl

.github/settings.yml

@@ -25,4 +25,4 @@ repository:
   # description: ""
 
   # Use a comma-separated list of topics to set on the repo (ensure not to use any caps in the topic string).
-  topics: terraform, ibm-cloud, terraform-module
+  topics: terraform, ibm-cloud, terraform-module, mcp

.github/workflows/ci.yml

@@ -8,5 +8,5 @@ on:
 
 jobs:
   call-terraform-ci-pipeline:
-    uses: terraform-ibm-modules/common-pipeline-assets/.github/workflows/[email protected].1
+    uses: terraform-ibm-modules/common-pipeline-assets/.github/workflows/[email protected].2
     secrets: inherit

README.md

@@ -107,7 +107,7 @@ tim-mcp --log-level DEBUG
 
 ### HTTP Mode
 
-HTTP mode runs the server as a web service, ideal for network deployments and multiple concurrent clients.
+HTTP mode runs the server as a stateless web service, ideal for network deployments and multiple concurrent clients. The server runs in stateless mode, which means no session IDs are required and each request is handled independently.
 
 ```bash
 # HTTP mode with defaults (127.0.0.1:8000)
@@ -127,6 +127,12 @@ tim-mcp --http --log-level DEBUG
 - Server runs at: `http://host:port/`
 - MCP endpoint: `http://host:port/mcp`
 
+**Stateless Operation:**
+- No session IDs required for HTTP requests
+- Each request is processed independently
+- Ideal for load balancing and horizontal scaling
+- Simplified client implementation
+
 **Production HTTPS:**
 For production deployments requiring HTTPS, use nginx as a reverse proxy:
 

examples/http_deployment.md

@@ -4,11 +4,13 @@ This guide covers deploying TIM-MCP server using HTTP transport for network acce
 
 ## Overview
 
-HTTP transport mode enables TIM-MCP to run as a web service, allowing:
+HTTP transport mode enables TIM-MCP to run as a stateless web service, allowing:
 - Network access from remote clients
 - Multiple concurrent client connections
 - Integration with existing web infrastructure
 - Load balancing and reverse proxy configurations
+- No session ID requirements (stateless operation)
+- Horizontal scaling without session affinity
 
 ## Basic HTTP Deployment
 
@@ -34,6 +36,8 @@ The server will be available at:
 - Server: `http://127.0.0.1:8000/`
 - MCP endpoint: `http://127.0.0.1:8000/mcp`
 
+**Note:** The server runs in stateless mode, so no session IDs are required. Each request is handled independently, making it perfect for load balancing and scaling.
+
 ### Environment Variables
 
 Set environment variables for production:

tim_mcp/server.py

@@ -604,12 +604,15 @@ def main(transport_config=None):
         # Explicit STDIO mode
         mcp.run()
     elif transport_config.mode == "http":
-        # HTTP mode with specified host and port
+        # HTTP mode with specified host and port (always stateless)
         logger.info(
-            f"Starting HTTP server on {transport_config.host}:{transport_config.port}"
+            f"Starting stateless HTTP server on {transport_config.host}:{transport_config.port}"
         )
         mcp.run(
-            transport="http", host=transport_config.host, port=transport_config.port
+            transport="http",
+            host=transport_config.host,
+            port=transport_config.port,
+            stateless_http=True,
         )
     else:
         raise ValueError(f"Unsupported transport mode: {transport_config.mode}")