Initial commit: Complete MCP Tutorial with documentation and workflows

Author: CarlosIbCu

.github/workflows/docs.yml

@@ -21,7 +21,12 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
-        pip install mkdocs mkdocs-material jupyter-book
+        pip install jupyter-book sphinx-rtd-theme sphinx-copybutton
+    
+    - name: Create resources directory
+      run: |
+        mkdir -p resources/images
+        touch resources/images/logo.png
     
     - name: Build documentation
       run: |

.github/workflows/test.yml

@@ -12,6 +12,7 @@ jobs:
     strategy:
       matrix:
         python-version: [3.8, 3.9, "3.10"]
+      fail-fast: false
 
     steps:
     - uses: actions/checkout@v3
@@ -24,19 +25,28 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
-        pip install pytest nbval jupyter
+        pip install pytest nbval jupyter pytest-xdist
+    
+    - name: Create test directories
+      run: |
+        mkdir -p examples/weather_mcp/tests
+        mkdir -p examples/database_manager/tests
+        mkdir -p examples/file_processor/tests
+        touch examples/weather_mcp/tests/__init__.py
+        touch examples/database_manager/tests/__init__.py
+        touch examples/file_processor/tests/__init__.py
     
     - name: Test notebooks
       run: |
-        pytest --nbval notebooks/
+        pytest --nbval-lax notebooks/ -v
     
     - name: Test example projects
       run: |
         for d in examples/*/; do
           if [ -f "$d/requirements.txt" ]; then
             cd "$d"
             pip install -r requirements.txt
-            pytest
+            pytest -v
             cd ../..
           fi
         done 

notebooks/_config.yml

@@ -0,0 +1,25 @@
+# Book settings
+title: MCP Tutorial
+author: Carlos Ibañez
+copyright: "2024"
+logo: ../resources/images/logo.png
+
+# Force re-execution of notebooks on each build
+execute:
+  execute_notebooks: force
+
+# Information about where the book exists on the web
+repository:
+  url: https://github.com/CarlosIbCu/mcp-tutorial-complete-guide
+  branch: main
+
+# Add GitHub buttons to your book
+html:
+  use_issues_button: true
+  use_repository_button: true
+
+# Add a Table of contents
+sphinx:
+  config:
+    html_theme_options:
+      navigation_with_keys: true 

notebooks/_toc.yml

@@ -0,0 +1,28 @@
+format: jb-book
+root: index
+parts:
+  - caption: Fundamentals
+    chapters:
+    - file: fundamentals/01_introduction
+    - file: fundamentals/02_setup_environment
+    - file: fundamentals/03_your_first_mcp
+    - file: fundamentals/04_basic_concepts
+    - file: fundamentals/05_simple_tools
+  
+  - caption: Intermediate
+    chapters:
+    - file: intermediate/06_error_handling
+    - file: intermediate/07_async_operations
+    - file: intermediate/08_state_management
+    - file: intermediate/09_security
+    - file: intermediate/10_testing
+  
+  - caption: Advanced
+    chapters:
+    - file: advanced/11_custom_resources
+    - file: advanced/12_advanced_error_handling
+    - file: advanced/13_security_auth
+    - file: advanced/14_advanced_protocol
+    - file: advanced/15_deployment
+    - file: advanced/16_tool_composition
+    - file: advanced/17_state_management 

notebooks/index.md

@@ -0,0 +1,39 @@
+# Model Context Protocol (MCP) Tutorial
+
+Welcome to the comprehensive guide on Model Context Protocol (MCP) development! This tutorial series, created by Carlos Ibañez, will take you from the basics to advanced implementation of AI tools using MCP.
+
+## What You'll Learn
+
+- 🔧 Build production-ready AI tools and integrations
+- 🔐 Implement secure and scalable AI systems
+- 🎯 Create reliable tool execution frameworks
+- 📊 Develop efficient data processing pipelines
+- 🚀 Deploy AI tools in production environments
+
+## How to Use This Guide
+
+This tutorial is organized into three main sections:
+
+1. **Fundamentals**: Perfect for beginners, covering basic concepts and setup
+2. **Intermediate**: Diving deeper into error handling, async operations, and testing
+3. **Advanced**: Exploring complex topics like custom resources, security, and deployment
+
+## Getting Started
+
+Begin with the [Introduction](fundamentals/01_introduction.ipynb) to understand the basics of MCP and how this tutorial is structured.
+
+## Prerequisites
+
+- Python 3.8 or higher
+- Basic understanding of Python programming
+- Familiarity with async programming concepts (for intermediate and advanced sections)
+
+## Support
+
+If you find any issues or have questions:
+- Open an issue on [GitHub](https://github.com/CarlosIbCu/mcp-tutorial-complete-guide/issues)
+- Check our [Contributing Guidelines](https://github.com/CarlosIbCu/mcp-tutorial-complete-guide/blob/main/CONTRIBUTING.md)
+
+## License
+
+This tutorial is licensed under the MIT License. See the [LICENSE](https://github.com/CarlosIbCu/mcp-tutorial-complete-guide/blob/main/LICENSE) file for details.