Merge pull request #2963 from jasonrandrews/review2

Start tech review for Testcontainers and MCP

Author: jasonrandrews

content/learning-paths/cross-platform/automate-mcp-with-testcontainers/_index.md

@@ -1,20 +1,23 @@
 ---
 title: Automate MCP Server testing using Pytest and Testcontainers
 
+draft: true
+cascade:
+    draft: true
+
 minutes_to_complete: 60
 
-who_is_this_for: This is an intermediate topic for anyone interested in automating their end-to-end testing of MCP (Model Context Protocol) servers using specialized software packages called TestContainers and PyTest. 
+who_is_this_for: This is an introductory topic for software developers and QA engineers who want to automate integration testing of MCP (Model Context Protocol) servers using Testcontainers and PyTest.
 
 learning_objectives:
-    - Understand how TestContainers work for containerized testing of MCP servers.
-    - Write integration tests for MCP servers using PyTest and TestContainers.
-    - Configure GitHub Actions to run MCP integration tests in CI/CD pipelines.
+    - Set up Testcontainers with PyTest for containerized testing of MCP servers
+    - Write and run integration tests that validate MCP server functionality
+    - Configure GitHub Actions to automate MCP server testing in CI/CD pipelines
 
 prerequisites:
-    - A machine that can run Python 3 and Docker. 
-    - Familiarity with [Docker](/install-guides/docker/) and container concepts.
-    - Basic knowledge of Python and Pytest.
-    - The [Arm MCP Server](https://github.com/arm/mcp) running with AI assistant client.
+    - A computer with [Docker](/install-guides/docker/) and Python 3.11 or later installed
+    - Basic familiarity with Python, PyTest, and container concepts
+    - Familiarity with the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) specification
 
 author: Neethu Elizabeth Simon
 
@@ -36,6 +39,11 @@ tools_software_languages:
     - Testcontainers
     - MCP
 
+shared_path: true
+shared_between:
+    - servers-and-cloud-computing
+    - laptops-and-desktops
+
 further_reading:
     - resource:
         title: Arm MCP Server GitHub Repository

content/learning-paths/cross-platform/automate-mcp-with-testcontainers/introduction.md

@@ -8,9 +8,9 @@ layout: learningpathall
 
 ## What is MCP?
 
-The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. MCP servers provide AI models with context aware capabilities, such as code analysis, knowledge base lookups, and system introspection.
+The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. MCP servers provide AI models with context-aware capabilities, such as code analysis, knowledge base lookups, and system introspection.
 
-The Arm MCP Server is a reference implementation that provides AI assistants with tools and knowledge specifically for Arm architecture development, migration, and optimization. It includes capabilities like container architecture checking, code analysis with LLVM-MCA, and access to Arm Learning Paths.
+The Arm MCP Server provides AI assistants with tools and knowledge specifically for Arm architecture development, migration, and optimization. It includes capabilities like container architecture checking, code analysis with LLVM-MCA, and a knowledge base with content from Arm Learning Paths and other documentation.
 
 ## Why automate MCP server testing?
 
@@ -25,7 +25,7 @@ MCP servers expose multiple tools that AI assistants can invoke. As these tools
 
 Testcontainers is a Python library that provides lightweight, throwaway instances of Docker containers for testing. Instead of mocking your MCP server, you can spin up the actual Docker container, run tests against it, and tear it down automatically.
 
-![testcontainers alt-text#center](testcontainers.png "Figure 1. Testcontainers Flow")
+![Diagram showing Testcontainers workflow: test code creates a Docker container, runs tests against it, and automatically tears it down after completion#center](testcontainers.png "Figure 1. Testcontainers Flow")
 
 This approach offers several benefits:
 

content/learning-paths/cross-platform/automate-mcp-with-testcontainers/setup-environment.md

@@ -10,10 +10,18 @@ layout: learningpathall
 
 Before you begin, ensure you have the following installed on your machine:
 
-- Python 3.11 or later
+- Python 3.11 or later with the ability to create Python virtual environments
 - Docker Engine or Docker Desktop
 - Git
 
+If you are on Linux, you need the Python virtual environment package.
+
+For Debian or Ubuntu, run:
+
+```bash
+sudo apt install -y python3-venv
+```
+
 You can verify Docker is running by executing:
 
 ```bash
@@ -84,12 +92,6 @@ testcontainers
 pytest
 ```
 
-You can also install these packages directly:
-
-```bash
-pip install testcontainers pytest
-```
-
 ## Verify your setup
 
 Run a quick verification to ensure everything is configured correctly: