feedback on genai-mcp-build-custom-tools-python

Author: adam-cowley

asciidoc/courses/genai-mcp-build-custom-tools-python/modules/1-getting-started/lessons/2-setup/lesson.adoc

@@ -59,11 +59,11 @@ Throughout this course, you'll connect your MCP server to a Neo4j database with
 
 We have created a Neo4j Sandbox instance for you to use during this course, loaded with thousands of movies, actors, directors, and user ratings.
 
-To define the connection details as environment variables, create a `.env` file in the `server/` directory with the following values:
+To define the connection details as environment variables, create a `.env` file in the project root with the following values:
 
 
 [source,env,subs="attributes+"]
-.server/.env
+.env
 ----
 NEO4J_URI={instance-scheme}://{instance-ip}:{instance-boltPort}
 NEO4J_USERNAME={instance-username}
@@ -129,9 +129,9 @@ load_dotenv()
 # access the environment variables
 import os
 
-uri = os.getenv("NEO4J_URI", "bolt://localhost:7687")
-username = os.getenv("NEO4J_USERNAME", "neo4j")
-password = os.getenv("NEO4J_PASSWORD", "password")
+uri = os.getenv("NEO4J_URI")
+username = os.getenv("NEO4J_USERNAME")
+password = os.getenv("NEO4J_PASSWORD")
 ----
 ====
 

asciidoc/courses/genai-mcp-build-custom-tools-python/modules/1-getting-started/lessons/3c-create-first-server/code/solution.py

@@ -1,4 +1,4 @@
-= Create Your First MCP Server 
+= Create Your First MCP Server
 :type: challenge
 :order: 3
 
@@ -13,7 +13,7 @@ Your challenge is to create a simple MCP server that demonstrates the core conce
 ====
 If you haven't completed the setup lesson yet, go back to link:../2-setup/[Setting Up Your Development Environment^] to configure your Codespace and environment variables.
 
-You can keep the Codespace open while completing the course. 
+You can keep the Codespace open while completing the course.
 You can open your existing codespaces at link:https://github.com/codespaces[github.com/codespaces^].
 ====
 
@@ -80,10 +80,10 @@ uv add "mcp[cli]"
 === Step 4: Create your MCP server
 
 
-Open `main.py` in your editor and add the following code to create a simple MCP server:
+Open `strawberry/main.py` in your editor and add the following code to create a simple MCP server:
 
 [source,python]
-.main.py
+.strawberry/main.py
 ----
 from mcp.server.fastmcp import FastMCP
 
@@ -93,17 +93,17 @@ mcp = FastMCP("Strawberry")
 @mcp.tool()
 def count_letters(text: str, search: str) -> int:
     """Count occurrences of a letter in the text"""
-    return text.lower().count(search.lower()) 
+    return text.lower().count(search.lower())
 
 # Run the server when executed directly
 if __name__ == "__main__":
-    mcp.run(transport="streaming-http")
+    mcp.run(transport="streamable-http")
 ----
 
 [NOTE]
-.Streaming HTTP
+.Streamable HTTP
 ====
-This example uses the `streaming-http` transport method to run the server.
+This example uses the `streamable-http` transport method to run the server.
 This differs from `stdio` in that the client uses HTTP to communicate with the server.
 
 We have made this choice to make it easier to test the server in GitHub Codespaces with the interactive Python client.
@@ -130,7 +130,7 @@ If the server is running successfully, you will see output similar to:
 INFO:     Started server process [30256]
 INFO:     Waiting for application startup.
 [10/15/25 12:52:22] INFO     StreamableHTTP session manager     streamable_http_manager.py:110
-                             started                                                          
+                             started
 INFO:     Application startup complete.
 INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
 ----
@@ -166,7 +166,7 @@ The client will connect to your server and display an interactive menu showing a
 0. Exit
 ============================================================
 
-Select a tool, resource, or template (enter number): 
+Select a tool, resource, or template (enter number):
 ----
 
 Enter `1` to select the `count_letters` tool.
@@ -229,6 +229,8 @@ Try testing with different inputs to verify the tool works correctly. Press Ente
 
 You have just created and tested your first MCP server!
 
+Once you are finished, you can stop both the client and server by pressing `CMD+C` (Mac) or `Ctrl+C` (Windows) in the terminal windows where they are running.
+
 
 read::Mark as Completed[]