Merge branch 'http_simple' into http_simple_tests

Author: hillarysanders

README.md

@@ -35,6 +35,8 @@ heroku buildpacks:set heroku/python -a $APP_NAME
 # set a private API key that you create, for example:
 heroku config:set API_KEY=$(openssl rand -hex 32) -a $APP_NAME
 heroku config:set STDIO_MODE_ONLY=<true/false> -a $APP_NAME
+# set the remote server type (module) that your web process will use (only relevant for web deployments)
+heroku config:set REMOTE_SERVER_TYPE=<streamable_http_server/sse_server>
 ```
 *Note: we recommend setting `STDIO_MODE_ONLY` to `true` for security and code execution isolation security in non-dev environments.*
 
@@ -75,14 +77,14 @@ pip install -r requirements.txt
 ```
 
 ### Local Streamable HTTP, SSE
-If you're testing Streamable HTTP OR SSE, in one terminal pane you'll need to start the server:
+If you're testing (stateless) Streamable HTTP OR SSE, in one terminal pane you'll need to start the server:
 ```bash
 source venv/bin/activate
 export API_KEY=$(heroku config:get API_KEY -a $APP_NAME)
 # Either run src.streamable_http_server or src.sse_server, here:
 uvicorn src.streamable_http_server:app --reload
 ```
-*Running with --reload is optional, but great for local development*
+*Running with `--reload` is optional, but great for local development*
 
 Next, in a new pane, you can try running some queries against your server:
 #### Local Streamable HTTP, SSE - Example Requests

app.json

@@ -15,6 +15,10 @@
         "STDIO_MODE_ONLY": {
             "description": "Only allow tool requests via STDIO mode?",
             "value": "false"
+        },
+        "REMOTE_SERVER_TYPE": {
+            "description": "Tranport module name used for deployed web app (applicable when web formation size is >0). `streamable_http_server` or `sse_server`.",
+            "value": "streamable_http_server"
         }
     },
     "formation": [

example_clients/streamable_http_client.py

@@ -19,7 +19,6 @@ async def run(method_name: str, raw_args: str = None):
 
     headers = {"Authorization": f"Bearer {API_KEY}"}
 
-    # Proper unpacking: don't treat the 3rd item as part of the session
     async with streamablehttp_client(MCP_SERVER_URL, headers=headers) as (read_stream, write_stream, get_session_id):
         async with ClientSession(read_stream, write_stream) as session:
             await session.initialize()